eal 


§ 


SY 26-3857-0 
File No. $370-30 


OS/VS2 SVS 

Independent Component: 

Virtual Storage Access Method 
Systems (VSAM) Logic 


Release 1.7 


Feature Numbers 5083 
5084 


131M 


First Edition (January 1977) 


This edition applies to Release 1.7 of OS/VS2 and to any. subsequent releases of that system 
unless otherwise indicated in new editions or technical newsletters. 


The Feature Numbers that apply for OS/VS2 SVS (Program Number 5742-017) are: 


Number Meaning 

5083 Basic material; 1600 bpi, 9-track tape 
5084 Basic material; 6250 bpi, 9-track tape 
5472 Optional material; 1600 bpi, 9-track tape 
5473 Optional material; 6250 bpi, 9-track tape 


Information in this publication is subject to significant change. Any such changes will be 
published in new editions or technical newsletters. Before using the publication, consult the 
latest JBM System/370 Bibliography, GC20-0001, and the technical newsletters that amend 
the bibliography, to learn which editions and technical newsletters are applicable and 
current. 


Requests for copies of IBM publications should be made to the IBM branch office that 
serves you. 


Forms for readers’ comments are provided at the back of the publication. If the forms have 
been removed, comments may be addressed to IBM Corporation, P.O. Box 50020, 
Programming Publishing, San Jose, California 95150. All comments and suggestions 
become the property of IBM. 


© Copyright International Business Machines Corporation 1977 


C 


PREFACE 


This book describes the internal logic of the Virtual Storage Access Method 
(VSAM) and contains diagnostic information. It is directed to maintenance 
personnel and development programmers who require an in-depth knowledge 
of VSAM’s design, organization, and data areas. 


Organization of This Book 


This book has the following major divisions: 


Required Reading 


‘‘Introduction,’’ which describes the use of VSAM, how VSAM fits into the 
operating system, how VSAM interacts with the operating system and the 
user’s program, and the major components of VSAM. 


““Method of Operation,” which describes the functions performed by 
VSAM. 


‘Program Organization,”’ which describes the information contained in 
VSAM program listings and the flow of control between modules. 


“Directory,”’ which lists VSAM modules and the Method of Operation 
diagrams related to each module. 


‘“‘Data Areas,”’ which describes control blocks used by VSAM and 
describes the format of VSAM data, index, and catalog records. 


“Diagnostic Aids,’ which contains useful information for locating the 
cause of problems in the VSAM procedures. 


““Glossary,”’ which defines terms relevant to VSAM, and lists abbreviations 
used in this book and in the VSAM program listings. 


“Index,” which is a subject index to the book. 


The following books should be read and understood before using this one: 


Related IBM Publications 


OS/VS2 SVS Independent Component: Virtual Storage Access Method 
(VSAM) Programmer’s Guide, GC26-3868, which introduces VSAM 
concepts and contains definitive explanations of VSAM macro instructions. 


OS/VS2 SVS Independent Component: Access Method Services, 
GC26-3867, which describes the catalog record processing commands: 
DEFINE, ALTER, DELETE, LISTCAT, and CONVERTV. 


Introduction to the IBM 3850 Storage System (MSS), GA32-0028 
OS/VS Mass Storage System (MSS) Planning Guide, GC35-0011 


OS/VS Mass Storage System (MSS) Services: General Information, 
GC35-0016 


OS/VS Mass Storage System (MSS) Services: General Reference, 
GC35-0017 


OS/VS DADSAM Logic, SQ66-3787 


Preface 3 


e OS/VS Data Management Macro Instructions, GT00-0132 

e OS/VS Catalog Management Logic, STOO-0181 

e OS/VS JCL Reference, GT28-0618 

e OS/VS JCL Services, GT00-0141 

e OS/VS Message Library: VS2 System Messages, GT38-1002 
e OS/VS Open/Close/EOV Logic, STOO-0138 

e OS/VS Service Aids, GT28-0633 

‘© OS/VS Supervisor Services and Macro Instructions, GT27-6979 
e OS/VS System Management Facilities (SMF), GT0O0-0134 

e OS/VSI VSAM Cross Reference, SYB6-3844 

e OS/VS2 Checkpoint/Restart Logic, SQ66-3820 

e OS/VS2 Data Areas, ST68-0606 

e OS/VS2 Debugging Guide, GT28-0632 

© OS/VS2 I/O Supervisor Logic, SQ66-3823 

© OS/VS2 Supervisor Logic, SY27-7244 


¢ OS/VS2 SVS Independent Component: Access method Services, 
GC26-3867 


e OS/VS2 SVS Independent Component: (VSAM) Options for Advanced 
Applications, GC26-3870 


e OS/VS2 SVS Independent Component: Virtual Storage Access Method 
(VSAM) Programmer’s Guide, GC26-3868 


Using This Book 


This book is designed to be used with the VSAM program listings in the 
microfiche for VSAM and with OS/VS1 VSAM Cross Reference, 
SYB6-3844, also on microfiche cards. Cross-reference reports are described 
in ‘Microfiche Reference Aids” in “Diagnostic Aids.” 


The diagrams in ‘‘Method of Operation’’ describe the major functions 
performed by VSAM; these diagrams are intended to be your key to a module 
name (and procedure name, as appropriate) in the listing. See ‘““Reading 
Method of Operation Diagrams” in ‘‘Method of Operation” for a description 
of how to read these diagrams. For information on what is available in the 
program listings, ‘“Program Organization.” 
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SUMMARY OF ENHANCEMENTS 


New Data Areas 


Technical Changes 


Editorial Changes 


The following work areas have been added: 


e Resource pool parameter list (BLPRM) is used by Record Management for 
dynamic string addition and by data set management for internal 
processing 


e Close work area (CLW) is used for communication among the Close and 
temporary Close modules 


e Open work area is used by the VSAM Open modules 


¢ Keyword table (KEYWDTAB) is a branch table that controls execution of 
module IDA0191C and supports processing for the control block 
manipulation macros 


Diagrams CA and CB have been changed to support improved control block 
manipulation macro processing. 


A new control block manipulation return code is issued when a block to be 
displayed or tested does not exist because the data set is a dummy data set. 


Each CAXWA in the CAXWA chain contains a pointer to the CRA ACB. 
That pointer and the associated control block structure were added to Figure 
72, Open Catalog Control Blocks. 


Flowcharts that describe Catalog Management I/O functions have been given 
figure numbers 51.1 through 51.19. The new figure numbers are in the List of 
Figures following the Table of Contents, and they are referred to from the 
module directory. 


VSAM has several new functions and data structures for this release of SVS; 
alternate indexes, spanned records, reusable data sets, relative record data set, 
processing the index of a key-sequenced data set, shared resources among 
data sets, improved control-interval processing, backward sequential 
processing, catalog recovery, data staging for the IBM 3850 Mass Storage 
System, and virtual-storage management. These additions to VSAM change 
this logic manual in all its sections: method of operation diagrams (HIPOs), 
program organization figures (compendiums), directories, data areas, and 
diagnostic aids. The directories identify all the new modules and external 
procedures and indicate which HIPOs and compendiums refer to them. 


HIPOs and compendiums have been added for Record Management to 
document Buffer Management and I/O Management. 


Summary of Enhancements 15 


Alternate Indexes 


Spanned Records 


Reusable Data Sets 


Relative Record Data Set 


Alternate indexes for key-sequenced and entry-sequenced data sets add 

control blocks and complicate control block interrelationships. Opening and : 
closing a path (a base cluster and the alternate index through which access is J 
gained to it) more than double the number of HIPOs for Open and Close. 

Access by way of a path and alternate-index upgrading change and add 

HIPOs to Record Management. Defining and deleting alternate indexes, 

paths, and upgrade sets add HIPOs for the DEFINE and DELETE functions 

of Catalog Management, add types of catalog records, and change many 

catalog control blocks. 


Having data records longer than one control interval changes a number of 
HIPOs in Record Management. It changes the contents of control information 
in the RDFs in a control interval. 


The catalog record processing required when a VSAM data set or alternate 
index is reused adds a HIPO to Catalog Management. 


The relative record data set brings to three the number of types of VSAM 
data sets. It changes the contents of control information in the RDFs in a 
control interval. It changes HIPOs and adds a HIPO to Record Management. 


Processing the Index of a Key-Sequenced Data Set J 


User access to the control intervals of a prime index changes HIPOs in 
Record Management to include the GETIX and PUTIX macros. 


Shared Resources among Data Sets 


Shared buffers, I/O-related control blocks, and channel programs among data 
sets for processing add control blocks and change control block 
interrelationships. Building and deleting a VSAM resource pool add a HIPO 
to Open/Close/End of Volume for the BLDVRP and DLVRP macros. 
Managing I/O buffers adds HIPOs to Record Management for the 
MRKBFR, WRTBER, and SCHBFR macros. 


Improved Control-Interval Processing 


Improved control-interval processing changes HIPOs in Record Management 
to show the bypassing of certain functions for faster processing. 


Backward Sequential Processing 


Backward sequential processing changes HIPOs in Record Management to 
include processing data records in descending sequence by RBA or key. 
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Catalog Recovery 


The optional recovery function that enables users to recover or restore data 
sets changes many HIPOs and adds a HIPO to Catalog Management. Catalog 
recovery changes the format of the catalog record header, adds types of 
catalog records, and adds field to various catalog control blocks. 


Data Staging for the IBM 3850 Mass Storage System 


Staging and destaging of data between mass storage and direct-access storage 
for the IBM 3850 Mass Storage System changes HIPOs for Open/Close/End 
of Volume and adds a HIPO to Catalog Management. 


Virtual-Storage Management 


The management of virtual storage has been cnetralized in Virtual-Storage 
Management, which controls most requests for storage. It adds control blocks, 
which are described in “‘Virtual-Storage Management” in ‘“‘Diagnostic Aids.” 
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INTRODUCTION 


Virtual Storage Access Method (VSAM) is an access method for use with 
OS/VS2 SVS. VSAM is used with direct-access storage devices to provide 
fast storage and retrieval of data. 


VSAM’s record format is different from that of other access methods. All 
VSAM records are stored in control intervals; a control interval is a 
continuous segment of auxiliary storage. A data set’s records can be ordered 
according to when the records are stored, where the records are stored, or 
what values are in each record’s key field. With key-sequenced data sets, the 
user can access a record by specifying its key or its relative byte address 
(RBA). With entry-sequenced data sets, the user can access a record only by 
specifying its RBA. With relative record data sets, the user can access a 
record by specifying its relative record number. For additional information on 
VSAM records and how they are stored, see ‘‘Data Areas.” 


User programs that contain indexed-sequential access method (ISAM) macro 
instructions can be used to process records in a VSAM data set. The ISAM 
interface program that allows the use of ISAM macro instructions builds the 
necessary VSAM control blocks when an OPEN macro instruction is issued 
and ensures that VSAM control blocks are properly initialized when 
subsequent requests are made for reading or writing records. 


VSAM resides in the pageable link pack area along with the user’s processing 
program. Figure 1 illustrates VSAM’s relationship to OS/VS, the processing 
program, and the data stored on a direct-access storage device and in mass 
storage. 


Virtual Storage 


po ine 


Logical 
Data 


Direct-Access 
Storage 


— ee ee SSS oe 


Program’s Address Space 


Mass 
Storage 


Figure 1. Relationship of VSAM, OS/VS, User’s Processing Program, and Staged Data 
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VSAM is controlled by user macro instructions. For additional information on 
user macro instructions, see OS/VS2 SVS Independent Component: Virtual 
Storage Access Method (VSAM) Programmer’s Guide and OS/VS2 SVS 
Virtual Storage Access Method (VSAM) Options for Advanced 
Applications. 


VSAM catalogs can contain entries for data sets that are stored on a mass 
storage volume with the IBM 3850 Mass Storage System, which is described 
in Introduction to the IBM 3850 Mass Storage System (MSS). 


VSAM communicates with other parts of the operating system through the 
SVC processor and through OS/VS control blocks used by VSAM. In 
addition to the OS/VS control blocks used by VSAM, VSAM builds and uses 
the access method control block (ACB). The ACB describes a VSAM data 
set in much the same way that a DCB describes a nonVSAM data set. 


In addition to processing records and data sets, VSAM opens and closes data 
sets and does most of its own direct-access device space management, that is, 
VSAM makes only minor use of OS/VS Open and Close and relies on 
OS/VS DADSM for only part of its direct-access device space management. 
To do much of this work, VSAM uses its own catalogs. VSAM catalogs 
contain a description of VSAM direct-access device space: where available 
space is, how space is used, and the location of data sets. For additional 
information on the VSAM catalog, see ‘“Catalog”’ in “Data Areas” and 
OS/VS Virtual Storage Access Method (VSAM) Programmer’s Guide. 


VSAM modules are logically grouped into the following components: 


e Open, which connects a user’s program to a VSAM data set and builds the 
control blocks required to permit the user to read from and write to the 
data set. 


e Close, which disconnects a user’s program from a data set and releases the 
data set’s control blocks built by Open. Close also updates statistics in the 
VSAM catalog. 


e End of Volume, which mounts volumes and allocates space. End of volume 
modifies the existing control blocks to reflect the newly mounted volumes 
and newly allocated space. 


e Record management, which reads and writes records in response to 
user-issued VSAM and ISAM macro instructions. This component also 
reads and writes records for the catalog management component and 
causes volumes to be mounted and demounted when it detects 
end-of-volume. 


e ISAM Interface, which allows user programs that contain ISAM macro 
instructions to process VSAM data sets. The ISAM Interface routines 
translate a user’s ISAM macro instructions into appropriate VSAM macro 
instructions and control blocks. The ISAM Interface routines next issue the 
VSAM macro instruction to read or write the user’s VSAM record. When 
the VSAM read/write operation completes, the ISAM Interface routine 
interprets the VSAM record management return codes and translates them 
into appropriate ISAM return-code information for the user’s program. 
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¢ Catalog management, which writes and updates catalog records. Catalog 
management processes the catalog to obtain and store information for 
Open, Close, End-of-Volume, and Access Method Services. 


e Control block manipulation, which allows the user program to create, 
modify, display, and test the contents of some VSAM control blocks (the 
ACB, EXLST, and RPL, which are described under ‘‘Data Areas’’ in this 
publication). 
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METHOD OF OPERATION 


A method of operation diagram describes one of the VSAM functions by _ 
listing the process steps required to complete the function, and by showing 
the data required for each process step and the data produced by each process 
step. 


Reading Method of Operation Diagrams 


Method of operation diagrams are functional descriptions of VSAM. The 
diagram and descriptive notes, keyed to the diagram, are on facing pages. 


The diagrams contain three blocks of information: input, processing, and 
output. The left-hand side of the diagram shows the data that serves as input 
to the processing steps in the center of the diagram, and the right-hand side 
shows the data that is output from the processing steps. Input is anything a 
program function refers to or gets. Processing is the steps required to fulfill 
the function represented by the diagram. Output is any change effected by a 
function; for example, register contents, or control blocks created or 
modified. The processing steps are numbered; the numbers correspond to 
notes on the facing page. The notes include cross-references to the listings. 
Figure 2 shows a method of operation figure. 


Diagram AC1. VSAM OPEN: Connect a User to a VSAM Data Set 


ISAM-User’s Address Space ISAM-User’s Address Space 
Thé ISAM-user’s program issued OPEN (SVC 19) fora 
VSAM data set. OS/VS Open enters VSAM here. 


Open 
Parameter 


ISAM-Interface Open Processing 


. Build the ISAM Interface contro! block — LICB — 
for each DCB for a VSAM data set being opened. 


-» 2. Build the VSAM user control blocks — ACB and 
EXLST — using information in the ISAM DCB. 


. Issue OPEN, SVC 19, to open the ACB. 


Data Set 
Information 
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VSAM-User’s Address Space, or 


ISAM-User’s Address Space after Step 3 VSAM- or ISAM-User’s Address Space 
: The VSAM-user’s program or |SAM-Interface Open : 
R 2 ) 
—- “ issued OPEN (SVC 19), OS/VS Open enters VSAM ae 


CB 
. Offset to 
R 
epistce 2 Entry in TIOT 
Q 


4, 
(17X20) > 5. Mount and verify volumes, 
23X26) 6. Open the object. 
a 


VSAM Open Processing 


Initialize for processing the user ACB. 


ACB 
ACBDEB 


eo © OOO 


(29(37) If a base cluster is being opened for output 
and has an upgrade set, open the upgrade 
set. 
(44) 8. If the dsname on the DD statement names 
_a a path, open the alternate index associated 
— * 
with the path. 
JFCB: 
REAM E (47X49Y52) 9. Prepare for subtask sharing and job step N 
termination. NNANAANALAANARALARAREA LALLA RARARARLUARRULLALAARRARRRRAACR ANN SARA 


Volsers 


a 10. Terminate Open processing. 
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Figure 2. Method of Operation Diagram 
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The left-hand side of the diagram shows the input required by the function 
shown in the diagram. For example, register 1 points to a list of DCB pointers 
for an ISAM user. The SYS1.SYSJOBQE contains the JFCB, which indicates 
the data set’s organization. The data-set information in the DCB is input to 
steps 1 and 2 in the processing portion of the diagram. The DDNAME is 
input to step 2 in the processing portion of the diagram. 


The processing portion of the diagram shows the processing steps required to 
fulfill the function described by the diagram. Note that the function described 
by one diagram might be performed by one or more VSAM modules; that is, 
the diagrams describe functions, not physical parts of the program. 


The figure shows two conditions for which VSAM Open is called: (1) at step 
1 when processing is to be done for an ISAM user program and (2) at step 4 
when processing is to be done for a VSAM user program or for an ISAM user 
program that has been processed by steps 1 through 3. The numbers 1, 2, 3, 
4, and 5 are keys to the notes for this diagram. 


The output created by each processing step is shown in the diagram. Step 1, 
for example, builds a control block (the IICB); step 2 builds VSAM user 
control blocks (the ACB and EXLST). 


Reading the method of operation diagrams requires that you understand the 
symbols they use. Figure 3 shows the symbols and describes their meaning. 


aa Flow of control on the same page; 


‘3’ indicates a number of a process 


3 step on the same page. 


GF Flow of control between pages; 
‘AA3’ is the diagram number and 
‘2’ is the number of a process step 
on that diagram. 


—_———_——_—_—> Pointers 
ae Reference to data or 
>(H) testing of data by a 
process step; ‘H’ is an 
(H)- saree arbitrary designation. 
aa Input to process steps 


and output from process 
———/) steps; ‘A’ isan arbitrary 
CQ aaee designation. 


Modification of data by 
a process step; ‘P’ is an 
arbitrary designation. 


Figure 3. Graphic Symbols Used in Method of Operations Diagrams 
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Figure 4 shows part of the notes to Figure 2. 


Notes for Diagram AC1 
OS/VS Open: Initial Processing: 
When the caller issues the OPEN macro instruction, SVC 


19, I|GCO0011 (OS/VS Open) is entered by the OS/VS 
SVC Interruption handler. 


OS/VS Open reads the JFCB from the SYS1.SYSJOBQE 
data set. 


ISAM Interface Open Processing: 


If the JFCB data-set organization (JFCDSORG) field 
indicates a VSAM data organization and the DCB 
data-set organization (DCBDSORG) indicates indexed 
sequential organization, IFGO196V (OS/VS Open) sets 
the identifier for each DCB-for-VSAM-data-organization 
entry inthe WTG table to ‘21°. the identifier of the 
ISAM-Interface Open routine. 


1 IDAO1921; BLDIICB, INITHCB 


The IICB serves as a bridge between the ISAM user 
program's DCB and the VSAM control blocks that 
allow the user's program to read and write VSAM 
records. 


See ‘Data Areas for details about the LICB. 


See OS/ES2 Dara Areas for details about the 
DCL. 


2 IDA01921: BLDIICB, INITHIICB, ACBMERGE 


The ISAM-Interface Open routine builds an ACB and 
an EXLST for each DCB for a VSAM data set being 
opened. The ACB is initialized with the DCB 
DDNAME and MACRF fields. 


See ‘Data Areas” for details about the ACB and 
EXLST 


3 1IDA01921: OPENACB 


The ISAM-Interface Open routine builds an open 
parameter list and issues SVC 19 to open the ACB. 


When VSAM Open processing completes (the ACB 
built in step 2 is open). ISAM Interface Open 
processing continues at step 58 (see Diagram AC7). 


VSAM Open Processing: 


If the open-parameter-list entry addresses a VSAM ACB, 
OS/VS Open sets the identifier field for each ACB entry 
in the WTG table to C'2A’, the identifier of the VSAM 
Open routine.All further OS/VS Open processing is 
bypassed for each ACB entry until the VSAM Open 
routine returns control to OS/VS Open at step $7 


4 See Diagram AC2. 


5 See Diagram AC3. 
This step is skipped for a dummy data set. 
6 See Diagram AC4. 


The object could be an alternate index that is itself 
being opened for processing by the user. 


7 See Diagram ACS. 

This step is skipped for a dummy data set. 
8 See Diagram AC6. 

This step is skipped for a dummy data set. 
9 IDA0192A: BLDDDEB 


VSAM Open builds a “dummy DEB” for the user 
ACB and adds its address to the job step's TCB DEB 
chain. (The device-dependent section of the DEB is set 
to 0.) Each open ACB ts identified by a dummy DEB 
in the chain. If the user's program ends abnormally. 
ABEND closes the ACB or DCB associated with each 
DEB in the chain. 


10 See Diagram AC7 
Note: Dynamic String Addition 


When OPEN is issued. not to open a data set. but to 
dynamically add a string to the user's capability to process 
multiple requests concurrently, the string is added and 
Open returns to the caller. VSAM Record Management 
requests dynamic string addition when more strings are 
required than the user specified. 


Record Management indicates dynamic string addition by 
a flag in the ACB. 


IDA0192Y (ENQBUSY) issues ENQ on ‘SYSVSAM with 
*B’ (busy) indicated to prevent Open from using the 
control block structure that is affected by dynamic string 
addition. 


IDAOI92Y (INITPLH) builds and initializes an additional 
PLH. LOB. and PFL. |DA0192Y (BLDBUFC) builds and 
initializes an additional BUFC and buffer. IDAQI92W 
builds an additional CPA and chains it to the BUFC. 
IDAO0192Y (DYNSTRAD) chains these new control 
blocks into the existing control block structure. (PLHDR 
points to the PLH, and BUFDR points to the BUFC.) 


Figure 4. Notes to Method of Operation Diagram 


The notes provide details about the processing shown in the diagram. For 
example, the entry process and conditions are described by the first 
(unnumbered) note. This note tells which OS/VS Open modules allow an 
ISAM user’s program to open an ACB for a VSAM data set; note 1 describes 
the use of the ITCB and directs you to “Data Areas’”’ in this publication for 
detailed information on the IICB. The notes also name the modules and 
routines that perform the functions represented. The module and procedure 
names allow you to relate a process step to a unit of code in the VSAM 


program listings. 
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Diagram AA1. Method of Operation Contents 


Macro 
Instructions: 


OPEN, CLOSE, 
CLOSE (TYPE=T), 
BLDVRP, DLVRP, 
CHKPT 


GET, PUT, 

POINT, CHECK, 
ENDREQ, ERASE, 
GETIX, PUTIX, 
MRKBRF, SCHBER, 
WRTBFR 


GENCB, 
MODCB, 
SHOWCB, 
TESTCB 


CATLG 
(From 
VSAM) 


CATLG 
(From 
AMS) 


VSAM Open, Close, and 
“End-of Volumn, and 
VSAM Checkpoint/Restart 


Diagrams ACI-All 


Record 
Management 


Diagrams BA1-BT I 


VSAM Control Block 
Manipulation 


Diagrams CA1-CB2 


VSAM Catalog 
Management 


Diagrams DA!-DM3 


VSAM Catalog 
Management Services 


Diagrams EA1-EM] 


ISAM Macro 
Instructions: 


OPEN 


CLOSE 


GET, PUT, PUTX, 
SETL, ESETL, 
RELSE, READ, 
WRITE, CHECK, 
FREEDBUF 


LEGEND 


ISAM Interface 
Open 


Diagrams AC 1, AC7 


ISAM Interface 
Close 


Diagrams ADI. AD6 


ISAM Interface 
Processing 


Diagrams BUI-BU2 


Flow of control on the same page: 
‘3° indicates a number of a process 
step on the same page. 


Flow of control between pages: 
‘AA3° is the diagram number and 
‘2° is the number of a process step 
on that diagram. 


Pointers 


Reference to data or testing of 
data by au process step: *°H’ is an 
arbitrary designation. 


Input to process steps and output 
from process steps: ‘A‘ is an 
arbitrary designation. 


Modification of data by a process 
step; ‘P’ is an arbitrary designation. 
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Diagram AB1. 
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BISAM — WRITE, READ, CHECK, 


QISAM — PUT, GET, PUTX, SETL, 
ESETL, and RELSE 


User-Issued VSAM PUT or PUTIX Macro 


User-Issued VSAM GET or GETIX Macro 


User-Issued VSAM ERASE Macro 


User-Issued VSAM POINT Macro 


Close-Issued VSAM-ENDREQ Macro 


User-Issued VSAM CHECK Macro 


User-Issued VSAM MRKBFR Macro 
User-Issued VSAM SCHBFR Macro 
User-Issued VSAM WRTBFR Macro 


VSAM Overview 


1. Open Processing (see Diagrams AC1, ‘““VSAM OPEN: 
Connect a User to a VSAM Data Set”’ and AFI, 
“BLDVRP/DLVRP: Build or Delete a VSAM 
Resource Pool” 


User-Issued OS/VS OPEN Allow a user to store or retrieve records ina VSAM 
Macro (SVC [ or data set—or build a VSAM resource pool for 
BLDVRP Macro processing with shared resources. 


2. Record Management Processing 


ISAM-Interface Processing (see Diagram BUI, BU2 
“ISAM-Interface: Processing a VSAM Data 
Set with an ISAM User’s Program’’). 


Translate the request into its VSAM equivalent 
(if necessary ). 


VSAM Request Processing (see Diagram BB1). 


and FREEDBUF 


Store a record or control interval. 
Retrieve a record or control interval. 
Delete a record. (B) 


Locate a record. 


Terminate request processing. 


Ensure completion of an asynchronous request. 


Mark a buffer in the VSAM resource pool for 
output or release. Search a buffer pool in the 
VSAM resource pool for a control interval. 
Write a buffer or buffers in the VSAM resource 
pool. 


Restore processing statistics for a newly created 
data set following a system crash. 


‘: WS WANS 


\s 


@ 


Ce 


User’s Virtual Storage 


Control 
Interval 


VSAM Control 
Block Structure 


Ey 
CO 


VSAM 
Data 
Set 
(Open) 


67 UoljeIadO jo poywwp 


C C C 
Diagram AB2. VSAM Overview 
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3. Close Processing (see Diagrams AD1, “VSAM 
CLOSE: Disconnect a User from a VSAM Data 
Set” and AF1, BLDVRP/DLVRP: Build or 
Delete a VSAM Resource Poo]’’). 


Disconnect a user’s processing program from its 
associated VSAM data set or delete the VSAM 
resource pool. 


User-Issued OS/VS 
CLOSE Macro (SVC 20) 
or DLVRP Macro 


User’s Record Area 


4. Control Block Manipulation Macro Processing (see 
Diagram CA1, ““GENCB” and Diagram CB1, 
““MODCB, SHOWCB, and TESTCB’’). 


User’s Virtual Storage 


reer 


~S, 


Control 
Interval 


Control Interval 


1 ACB, RPL, or EXLST 


User-Issued VSAM 
GENCB Macro 


Build a new control block. 


User-Issued VSAM Modify, display, or test a control block. 
MODCB, SHOWCB or 


TESTCB Macros 
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Diagram ACI. VSAM OPEN: Connect a User to a VSAM Data Set 


ISAM-User’s Address Space ISAM-User’s Address Space 
The ISAM-user’s program issued OPEN (SVC 19) fora 
VSAM data set. OS/VS Open enters VSAM here. 
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ISAM-Interface Open Processing 
_|- >] 1. Build the ISAM Interface control block — IICB - 
for each DCB for a VSAM data set being opened. 


> 
-» 2. Build the VSAM user control blocks — ACB and 
EXLST — using information in the ISAM DCB. 


3. Issue OPEN, SVC 19, to open the ACB. 
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The VSAM-user’s program or ISAM-Interface Open 
issued OPEN (SVC 19). OS/VS Open enters VSAM 
here. 
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and has an upgrade set, open the upgrade 
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. If the dsname on the DD statement names 
a path, open the alternate index associated 
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10. Terminate Open processing. 
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Notes for Diagram AC1 
OS/VS Open: Initial Processing: 
When the caller issues the OPEN macro instruction, SVC 


19, IGCO0001I (OS/VS Open) is entered by the OS/VS 
SVC Interruption handler. 


OS/VS Open reads the JFCB from the SYS1.SYSJOBQE 
data set. 


ISAM Interface Open Processing: 


If the JFCB data-set organization (JFCDSORG) field 
indicates a VSAM data organization and the DCB 
data-set organization (DCBDSORG) indicates indexed 
sequential organization, IFGO196V (OS/VS Open) sets 
the identifier for each DCB-for-VSAM-data-organization 
entry in the WTG table to ‘2I’, the identifier of the 
ISAM-Interface Open routine. 


1 IDA01921; BLDIICB, INITIICB 


The IICB serves as a bridge between the ISAM user 
program’s DCB and the VSAM control blocks that 
allow the user’s program to read and write VSAM 
records. 


See ‘‘Data Areas” for details about the IICB. 


See OS/VS2 Data Areas for details about the 
DCB. 


2 IDA01921: BLDIICB, INITIICB, ACBMERGE 


The ISAM-Interface Open routine builds an ACB and 
an EXLST for each DCB for a VSAM data set being 
opened. The ACB is initialized with the DCB 
DDNAME and MACKRF fields. 


See ‘“‘Data Areas’ for details about the ACB and 
EXLST. 


3 IDA0192I: OPENACB 


The ISAM-Interface Open routine builds an open 
parameter list and issues SVC 19 to open the ACB. 


When VSAM Open processing completes (the ACB 
built in step 2 is open), ISAM Interface Open 
processing continues at step 58 (see Diagram AC7). 


VSAM Open Processing: 


If the open-parameter-list entry addresses a VSAM ACB, 
OS/VS Open sets the identifier field for each ACB entry 
in the WTG table to C‘2A’, the identifier of the VSAM 
Open routine.All further OS/VS Open processing is 
bypassed for each ACB entry until the VSAM Open 
routine returns control to OS/VS Open at step 57. 


4 See Diagram AC2. 


C 


5 See Diagram AC3. 
This step is skipped for a dummy data set. 
6 See Diagram AC4. 


The object could be an alternate index that ts itself 
being opened for processing by the user. 


7 See Diagram ACS. 

This step is skipped for a dummy data set. 
8 See Diagram AC6. 

This step is skipped for a dummy data set. 
9 IDA0192A: BLDDDEB 


VSAM Open builds a “dummy DEB” for the user 
ACB and adds its address to the job step’s TCB DEB 
chain. (The device-dependent section of the DEB is set 
to 0.) Each open ACB is identified by a dummy DEB 
in the chain. If the user’s program ends abnormally, 
ABEND closes the ACB or DCB associated with each 
DEB in the chain. 


10 See Diagram AC7. 
Note: Dynamic String Addition 


When OPEN is issued, not to open a data set, but to 
dynamically add a string to the user’s capability to process 
multiple requests concurrently, the string is added and 
Open returns to the caller. VSAM Record Management 
requests dynamic string addition when more strings are 
required than the user specified. 


Record Management indicates dynamic string addition by 
a flag in the ACB. 


IDA0192Y (ENQBUSY) issues ENQ on ‘SYSVSAM with 
‘B’ (busy) indicated to prevent Open from using the 
control block structure that is affected by dynamic string 
addition. 


IDA0192Y (INITPLH) builds and initializes an additional 
PLH, IOB, and PFL. IDA0192Y (BLDBUFC) builds and 
initializes an additional BUFC and buffer. IDA0192W 
builds an additional CPA and chains it to the BUFC. 
IDA0192Y (DYNSTRAD) chains these new control 
blocks into the existing control block structure. (PLHDR 
points to the PLH, and BUFDR points to the BUFC.) 
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Diagram AC2. VSAM OPEN: Initialize for Processing the User ACB 
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Notes for Diagram AC2 


11 IDAO192A: INIT192A 


The open work area is mapped by the IDAOPWRK 
macro. 


13 IDA0192C 


The user establishes the numberof times the operator 
may attempt to supply the correct password, as 
described in OS/VS2 SVS Independent Component: 
Access Method Services. If the correct password isn't 
supplied, VSAM Open sets the ‘““ACB not opened’ 
return code in register 15 and the “user password 
invalid’ flag in ACBERFLG. 


14 IDA0192C: LOC1 


LOCI issues a LOCATE (SVC 26) to obtain data-set 
type, catalog ACB address, catalog recovery area 
volume serial number, and control-interval number for 
each data set associated with the object named on the 
DD statement. 


15 IDA1092A: BLDLISTS 


During termination the ENQs indicated in the ESL 
(enqueue save list) will be dequeued, the DEBs 
indicated in the DSL will be unchained, and the 
storage (“‘core’’) indicated in the CSL will be freed, 
the SSL enables Open to chain control blocks at the 
end of Open processing. 


16 IDA0192A: BLDENQPL, INIT192A 


Open enqueues on each data set to prevent it from 
being opened by other tasks during the current Open 
processing. 


17 IDA0192A: CONBASE 


If the IDF field in the AMBL of the data set being 
opened matches the IDF field of an AMBL on the 
primary chain, the control blocks for the base cluster 
already exist. 


Zo] (INVSA) Poul sseody a3eIOIg [eNLIA :JUaUOdUIOZ jUapuadapuU] SAS ZSA/SO FE 


Diagram AC3. VSAM OPEN: Mount and Verify Volumes 
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Notes for Diagram AC3 


21 IDA0192F: VOLMNT 
22 IDA0192F: OLDDEV 
24 IDA0192V 


A volume in the JSCB and extensions is already 
mounted if a UCB allocated to the DD statement that 
is associated with the user ACB indicates so. 


26 IDA0192V: OLDDEV, NEWDEV 


A volume mount table is built for each device type 
allocated to the DD statement that is associated with 
the user ACB. Each VMT contains an entry for each 
successfully mounted volume of that device type. If a 
VMT already exists for a device type, the new VMT 
replaces the old one. 
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Diagram AC4. VSAM OPEN: Open the Base Cluster 
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Notes for Diagram AC4 
27 IDA0192F: OPNBASE, BLDAMBL, CHNAMBL, 
VATUPD 


Unless the user ACB indicates that a catalog is to be 
opened or that a catalog recovery area is to be built in 
system storage (SCRA), the AMBL is added to the 
chain and its address is added to the valid-AMBL 
table. The VAT is used for checking AMBLs for 
validity. AMBLVC identifies the VAT and the entry in 
the VAT that contains the address of the AMBL. 


28 IDA0192F: CHNAMBL 
29 IDA0192F: CHNAMBL 


The AMBL is put on the secondary chain, off the 
primary AMBL for the base cluster. 


30 IDA0192F: BLDCMB 


31 IDA0192B, IDA0192C: OPCAT 1 (calls LOC2 and 
LOC3) 


A separate CTGFL is built for each catalog record 
field requested by VSAM Open. A CTGFL gives the 
field’s length and its address in the open work area. 


See ““Data Areas’”’ for details about the data set 
catalog record, the CTGPL, and the CTGFL. 


32 IDA0192B, IDA0192C: LOC2, LOC3 


The index catalog record is pointed to by the cluster 
catalog record. See ““Data Areas” for details about the 
index catalog record. 


33 IDA0192B 


A volume mount table must exist for each device type 
required by the cluster. 


34 IDA0192Z, IDA0192W 


The following figures in ““Data Areas”’ show the 
VSAM control block structure: 


e VSAM Control Block Structure for a 
Key-Sequenced Data Set (VSAM User) 


¢ VSAM Control Block Structure for a 
Key-Sequenced Data Set Accessed through a Path 


e Shared VSAM Control Block Structure for a 
Key-Sequenced Data Set Accessed through Two 
Paths 


e Data AMB Control Block Structure 
e Alternate-Index AMB Control Block Structure 


e Local Shared Resources Control Block Structure 


C 


¢ AMB Control Block Structure with Local Shared 
Resources 


“Data Areas”’ also describes each VSAM control 
block. 


36 IDA0192F: OPNBASE, PAGEFIX 


The user must be authorized to have pages fixed in 
real storage—his program must be in supervisor state 
with protection key 0 or link-edited with APF 
authorization. 


All storage identified by the cluster management block 
is fixed. 


37 IDA0192F: OPN BASE 
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Diagram ACS. VSAM OPEN: Open the Upgrade Set 
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Notes for Diagram AC5 
38 IDA0192F: OPNUPGR 


The upgrade table contains an entry for each alternate 
index in the upgrade set. 


39 IDA0N192F: OPNUPGR, BLDAMBL 


An RPL, an ACB, and an AMBL are built for each 
alternate index. 


40 IDA0192F: OPNUPGR 


The AMBLs for paths already open in the job step are 
searched for the alternate index being processed. 


IDA0192Y 


To provide an additional string for upgrading an 
alternate index that is already open for processing by 
way of a path, IDA0192Y builds the PLH, BUFC, 
IOB, CPA, and buffers. These control blocks are 
described in ‘“Data Areas.” 


41 IDA0192F: BLDCMB 

42 See notes for steps 31 and 32. 
43 See note for step 33. 

44 See note for step 34. 
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Diagram AC6. VSAM OPEN: Open the Alternate Index Associated with the Path 
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Notes for Diagram AC6 
45 IDA0192F: OPNPATH, BLDAMBL 


The AMBL is chained off the current AMBL for the 
base cluster. Its address is added to the valid-AMBL 
table. The VAT is used for checking AMBLs for 
validity. AMBLVC identifies the VAT and the entry in 
the VAT that contains the address of the AMBL. 


46 IDA0192F: CONPATH 


The alternate index is already open for this path if one 
of the path AMBLs contains the same ID as this 
alternate index. 


47 IDA0192F: OPNPATH 


The AMBL is chained off the existing AMBL for the 
path. 


48 IDA0192F: CONPATH 


The alternate index is already open for upgrading if 
one of the AMBLs pointed to by the upgrade table 
contains the same ID as this alternate index. 


49 IDA0192F: CONPATH 


For each string required for processing the path, 
IDA0192F builds the PLH, BUFC, CPA, IOB, and 
buffers. These control blocks are described in “‘Data 
Areas.” 


50 See notes for steps 31 and 32. 
51 See note for step 33. 
52 See note for step 34. 
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Diagram AC7. VSAM OPEN: Terminate Open Processing 
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Notes for Diagram AC7 


53 IDA0192A: TERM192A, UPSMF 
54 IDA0192S 


See OS/VS System Management Facilities (SMF) for 
details about SMF record type 62. 


55 IDA0192A: TERM192A, CLNUP 


CLNUP resets open indicators in the VSAM catalog 
for data sets that were processed. It unchains AMBLs 
and deletes entries from the valid-AMBL table. It 
unchains DEBs. It decrements any use counts that 
were incremented. 


CLNUP deletes all volume mount table entries that 
were added. 


56 IDA0192A: DEQBUSY 


A DEQ is issued for each data set that was enqueued 
busy (in step 16) to allow other tasks to open them. 


57 IDA0192A 


The VSAM Open routine sets the ACB’s open bit 
(ACBOFLGS) on if the ACB is opened successfully. If 
an error occurs while opening an ACB, the VSAM 
Open routine or OS/VS Open sets the appropriate 
error flag. 


OS/VS Open: Final Processing (after VSAM Open 
Processing completes): 


The VSAM Open routine returns control to OS/VS Open 
by putting the identifier of the Open Final Termination 
routine, C’8N’, in the WTG table and transferring control 
(through the IECRES macro instruction) to the 
O/C/EOV resident routine. The resident routine 
examines the open parameter list and, if all ACB entries 
have been processed by the VSAM Open routine, returns 
to the OS/VS Open Final Termination routine. If not, the 
next ACB entry in the open parameter list is processed 
(return to step 4, Diagram AC1). 


OS/VS Open modules (IFG0196V and IFG0196W) 
ensure that an ACB entry in the open parameter list is not 
processed by any access method executor routine. 


IFGO196V sets the identifier for each VSAM ACB entry 
in the WTG table to 0. 


IFGO196W sets the identifier for each VSAM ACB entry 
in the WTG table to C‘8N’, the identifier of the OS/VS 
Open Final Termination routine. 


IFGOI198N sets the return code in register 15. 


C 


See “‘Diagnostic Aids” for details about the VSAM Open 
return codes and error codes. 
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Diagram AC8. VSAM OPEN: Connect a User to a VSAM Data Set 
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Notes for Diagram AC8 
ISAM Interface Open Processing (continued): 
58 IDA01921: OPENACB 


The ISAM-Interface Open routine sets the DCB open 
bit (DCBOFLGS) to 1 if the DCB’s associated ACB 
was opened correctly. 


60 IDA0192I: DCBMERGE and AMSMERGE 


See OS/VS2 Data Areas for details about the 
DCB. 


61 IDA0192I: DCBEXIT 


Register contents passed to the user’s DCB exit 
routine are: 


e RI: address of DCB 

¢ R2: through 13: User’s registers 

¢ R14: return address 

¢ R15: address of user’s DCB exit routine 

IDA0192I: BFRMERGE 

Merge buffer-related information into the DCB. 
62 IDA0192I: VALIDCHK 

ABEND 038 is issued when: 


e Access Method Services and DCB values for 
LRECL, KEYLE, and RKP are not equal, or when 


¢ Reload is attempted—the DCB is opened for 
OUTPUT with DISP=OLD and the DCB’s data set 
contains records. 


63 IDA0192I: BUILDDEB 


The ISAM-Interface Open routine builds a DEB so 
that: 


e There is meaningful DEB information for the 
user’s program to examine; 


e The DEB fields on which COBOL, PL/I, and the 
ISAM System Integrity Feature depend are 
properly initialized; 


e The checkpoint/restart or abnormal end (ABEND) 
routines can examine the task’s DEB chain and 
close all of the user’s DCBs and ACBs; and 


e The user’s program cannot modify the IICB 
address or other fields in the DEB. 


The DEB’s ISAM-Interface indicator is now set on. 


C 


See OS/VS2 Data Areas for details about the 
DCB, DEB, and TCB. 


64 IFG0192I: LOADMOD 


The appropriate ISAM Interface modules are loaded. 
DCB fields are initialized to point to the ISAM 
Interface processing routine that will translate an 
ISAM record-processing request into a VSAM request. 


The ISAM SYNAD routine is loaded when it is 
specified in the user’s JCL AMP parameter. 


The EXLST (built in step 2, Diagram AC1) addresses 
ISAM Interface exit routines. 


See ‘Data Areas” for details about the EXLST. 


The DEB (built in step 63) is initialized to point to the 
ISAM Interface FREEDBUF routine. 


65 IDA01921: BLDRPL, INITRPL, BLDBUFR 


RPLs and ISAM Interface buffers are built for each 
ACB (the number of RPLs and buffers is based on the 
ACB’s STRNO value for BISAM; one of each is built 
for each QISAM DCB) that the ISAM user opens. 
Two of the uses of the ISAM Interface buffers are to 
support ISAM locate mode and dynamic buffer 
processing. 


IDA01921: DCBINIT 


When the ISAM Interface Open processing completes, 
the DCB open flags (DCBOFLGS) field contains: 


¢ Busy bit off (set to 0) 
¢ Open bit on (set to 1) 
¢ Lock bit off (set to 1) 


OS/VS Open: Final Processing (after ISAM Interface 
Open Processing completes): 


OS/VS Open modules (IFG0196V and IFG0O196W) 
ensure that a DCB for a VSAM entry in the open 
parameter list is not processed by any access method 
executor routine. 


IFGO196V sets the ID field for each DCB-for-VSAM 
entry in the WTG table to 0. 


IFG0196W sets the identifier field for each 
DCB-for-VSAM entry in the WTG table to C’8N’, the 
identifier of the OS/VS Open Final Termination 
module (IFGO198N). 


IFGO198N sets the return code in register 15. 


CC 


If the ACB (built by the ISAM Interface Open routine 
in step 2, Diagram AC1) is not opened correctly by the 
VSAM Open routine, the ISAM-Interface Open 
routine sets the DCB open bit to 0 (DCBOFLGS) and 
sets all DCB module-address fields to 0. If the user’s 
ISAM program issues an ISAM record processing 
request without confirming that the DCB is 
successfully opened, an ABEND 0C4 results, caused 
by a branch to address 000. 
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Diagram AD1. VSAM CLOSE: Disconnect a User from a VSAM Data Set 
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Notes for Diagram AD1 


Note: If CLOSE (TYPE=T) is issued, the data set’s 
catalog information is updated to reflect its current status 
and an SMF record is written. See ““Temporary Close 
(TYPE=T) of a VSAM Cluster” in the Program 
Organization compendiums for details on the CLOSE 
(TYPE=T) process. 


ISAM Interface Close Processing: 


If the DCB data-set organization (DCBDSORG) field 
indicates that an ACB is being processed and if the 
DEBFLGS1 field (in the DEB) indicates ISAM Interface 
processing, OS/VS Close modules (IGC00020 and 
IFGO200V) do the following: 


1GC00020: Bypasses purging of the outstanding EXCP 
requests. 


IFGO200V: Bypasses DSCB processing and transfers 
control to the ISAM Interface Close routine, IDA0200S. 


1 IDA0200S: FLUSHBFR 


The ISAM Interface Close routine issues a SYNCH 
macro instruction to transfer control to the ISAM 
Interface Load routine, which issues the final PUT 
request, if all of these conditions exist: 


« The DCB was opened for output in the locate 
mode and a PUT request was issued prior to the 
CLOSE request (indicated in the DCBMACRF 
field). 


« Noerrors occurred (indicated in the DCBEXCD 
field). 


« The ACB associated with the user program’s DCB 
was not previously closed (indicated in the 
ACBOFLGS field). 


See ‘““‘Data Areas’ for details about the ACB. 


See OS/VS2 Data Areas for details about the 
DCB and DEB. 


2 IDAO0200S: DELETRTN 


The ISAM Interface Close routine resets each DCB 
module address field. Virtual storage for the routines 
is released to the system by issuing a DELETE macro 
instruction against the ISAM Interface routines that 
were loaded by ISAM Interface Open processing. 


3 IDA0200S: CLOSEACB 


The ISAM Interface Close routine issues a CLOSE 
macro instruction (SVC 20) to close the VSAM ACB. 


When VSAM Close processing completes (the ACB 
built during ISAM Interface Open processing is 


closed), ISAM Interface Close processing continues at 
step 68 (see Diagram AD6). 


VSAM Close Processing: 


OS/VS Close modules (I{GC00020 and IFG0200V) allow 
an ACB to be closed. 


IGC00020 bypasses the DEB validity check and the 
purging of outstanding EXCP requests and, if a VSAM 
catalog is being closed, calls IFGO200N to locate the 
TIOT entry and read the JFCB for the catalog ACB. 


IFGO200V reads the JFCB for non-catalog ACBs and 
tests for the user program’s diagnostic options (i.e. 
Generalized Trace Facility), and sets the ID field for each 
ACB entry in the WTG table to COT’, the identifier of 
the VSAM Close module. 


The input is from IFGO200T. 
4 IDA0200T: INIT200T, GETCORE 


The module work area and the close work area are 
built. 


If neither a catalog nor a catalog recovery area in 
system storage (SCRA) is being closed, the dummy 
DEB is verified. Unless a dummy data set is being 
closed, IDA0200T (ENQFUNC, ENQINIT, 
PARMINIT) builds an ENQ parameter list and issues 
ENQ for every data set associated with the user ACB. 
The parameter list indicates ‘“SYSVSAM ‘as the major 
resource and control-interval number of the data set, 
catalog ACB address, and ‘B’ (busy) as the minor 
resource. 


6 IDA0200T: FLQUIS, ENDIO 


If the close is not for an ABEND and is not for 
improved control-interval access to load a data set or 
process the mass storage volume inventory data set, 
the data set is flushed and quiesced (that is, any I/O 
activity yet to be done or already started is done): 


An inner RPL its built and pointed to the user ACB. 
The PLH chain is searched for PLHs connected to the 
user ACB. The inner RPL is connected to each PLH 
and an ENDREQ macro is issued. No record is 
returned for an incomplete input request (GET or 
POINT). The output buffer is written to the VSAM 
data set for an incomplete output request (PUT or 
ERASE). After I/O completes, the inner RPL is freed. 


7 IDA0200T: CLSPATH 


The alternate index in a path is closed before the base 


a 


cluster. See Diagram AD2. 
IDA0200T: CLSBASE 


The cluster being closed may be a base cluster (part of 
a path), a cluster that was not processed through a 
path, or an alternate index that was itself processed by 
the user. See Diagram AD3. 


IDA0200T: CLSPHERE 


This processing is not done if an ACB for the cluster is 
still open. For example, two users might have been 
processing a cluster, and the first user is closing his 
ACB. See Diagram AD4. 


10 IDA0200T: TERM200T 


Before termination processing, the base AMBL is 
freed. See Diagram AD6. 
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Diagram AD2. VSAM CLOSE: Close the Alternate Index in a Path 
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Notes for Diagram AD2 


Except for step 20, all the processing in this diagram is 
done by IDAO200B. 


12 
When an upgrade AMBL exists for the alternate indes 
being closed, a partial close is. indicated for Diagram 
AD5 processing. For a partial close, only the string 
blocks for the path, not for the upgrade set, are closed. 


For a primary close, the last user is closing his ACB 
for the base cluster—no primary AMBL or related 
control blocks need be kept for further user 
processing. 


15 
For a secondary close, at least one more user still has 
an ACB open for the base cluster—the primary 
AMBLs and related control blocks must be kept for 
further user processing. 


17 
See note for step 15. 


18 
See Diagram ADS. 


20 IDA0200T: RMOVAMBL 
The storage for the AMBL is freed. 
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Diagram AD3. VSAM CLOSE: Close the Base Cluster (or a Cluster Not in a Path) 
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Notes for Diagram AD3 


The cluster being closed can be a base cluster that was 
being processed through a path, a cluster that was not 
being processed through a path, or an alternate index that 
was itself processed by the user. 


Except for some processing following step 33, IDA0200B 
does all the processing in this diagram. 


24 
For disconnecting the AMBL and changing AMBL 
pointers (step 26), an ENQ is issued to exclusively 
control the resources for the job step. 


26 
After AMBL pointers are changed, a DEQ is issued to 
free the resources for the job step. 


28 
See note for step 15. 


29 
See the explanation for a primary close in the note for 
step 12. 


31 
The inner ACB is used because the user ACB contains 
parameters for closing a path, not for closing a base 
cluster. 


32 
See Diagram ADS. 


33 IDA0200T: RMNOVAMBL 


If there was no error, register 2 is pointed back to the 
user ACB. Unless a catalog, a catalog recovery area in 
system storage (SCRA), or the mass storage volume 
inventory data set is being closed, the AMBL is 
removed from the valid-AMBL table. 
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Diagram AD4. VSAM CLOSE: Close Upgrade Alternate Indexes and Free Storage 


AMBL BIB 35. Is there an upgrade table? Close Work Area 
— 
_— Yes No 
Pa 
a ¥ 


36. Indicate a primary close is being done. 


AMBLBIB LLL LL ALL SS A yp 


CLWPRMCL=1 


Repeat steps 37 and 38 for each alternate index in 


the upgrade set: Register 2 


a 


37. Point to the upgrade ACB. IID | Upgrade ACB 


UPT 


@ . Close the upgrade alternate index.>(50) 
Register 15 o as there an error in a close? 
ey ee UPTRPL RPLDACB ACBAMBL 
a ae $ « —a 


40 Remove the upgrade AMBL(s) from the valid- 
AMBL table. 


41. Turn off the close indicator in the close work 
area. Zp 


42. Decrement UCB use counts. 2>(B) TIOEFSRT 
43. Free volume mount tables. 


44. Remove the AMBL pointed to by the BIB from 
the valid-AMBL table. 
Working 


BIBWSHD Storage 45. Free working storage, sphere block, and 
protected sphere block. 


AMBLBIB 


> 
<= 
wo 
eS 


BIBVMT 


BIBSPHPT 
46. Delete modules loaded by Open. 


47. If the user’s SYNAD routine was loaded by 
Open, delete it. 


BIBPRSPH 


Protected Workin : 
Sphere Block Sioee 48. Free the base information block. 
Oss If processing was with shared resources, 


decrement the VSRT use count. VSRT 


oe 


© 
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Notes for Diagram AD4 


35 IDA0200T: CLSUPGR 
37 IDA0200T: CLSUPGR 


After the last upgrade alternate index is closed, 
register 2 is pointed back to the user ACB. 


38 IDAO200T calls IDA0200B 
See Diagram ADS. 
40 IDA0200T: RMOVAMBL 
42 IDA0200T: VMTPROC, DCRUCBCT 


Use counts are decremented one way for closing a 
catalog and another way for closing other data sets: 


For closing a catalog, the UCB use count is 
decremented if the UCB indicated by the task I/O 
table is the same UCB as that indicated in the volume 
mount table. 


If neither a catalog nor a catalog recovery area is 
being closed and restart isn’t indicated, the UCB use 
counts in the volume mount table are decremented for 
those volumes with valid serial numbers. 


43 IDA0200T: FREECORE 
44 IDA0200T: RMOVAMBL 
45 IDA0200T: FREECORE, FREESPHR 


For information about the sphere block and the 
protected sphere block, see “"Virtual-Storage 
Management” in ‘Diagnostic Aids.” 


48 IDA0200T: FREECORE 


The base information block is described in 
‘“Virtual-Storage Management” in ‘Diagnostic Aids.” 
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Diagram AD5. VSAM CLOSE: Close a Cluster 
188238 


50. Check the validity of the ACB’s AMBL and 
DEBs. 


51. For processing with shared resources, write 
buffers marked for output. 


52. Is a primary close being done? 
No Yes 


Vv 


53. Release all shared resources that are no 
longer used. 


VSAM Catalog 


Data Component 
54. Update the catalog records for the data and CZZZZZZZZIZZIDD Record 
index components with statistics of the activity 
that occurred while the cluster was open. Index Component 


Record 
‘55. Decrement use counts for devices associated 


with the ACB. 
56. Does the OS/VS system include System 


Management Facilities (SMF)? VMT 
No Yes ae 
* 
57. Write SMF record type 64 — Data Set 
Status. aa 
Close Work Area _. —» 58. Is a secondary close being done? 
_ Yes No 


CLWPRMCL 
CLWSECCL 
CLWPARCL 


Data Set 
Activity Information 


¥ SMF Data Set 
as -> 59. Is a partial close being done? 
No Yes 
a2 
60. Delete VSAM DEBs from DEB table and 
unchain them. 


61. Demount volumes associated with the 
ACB. 
59) Register 15 


62. Free storage of control blocks associated with 
ence. 


c c c 


Volume Usage 


User’s Data 
Set Statistics 
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Notes for Diagram AD5 
50 IDA0200B: INIT200B, VALCHECK, PROBDT (calls 
IDA0192P) 


The DEBCHK SVC is used to check the validity of 
DEBs. 


51 IDA0200B: WRITBUFR, GETCORE, WRBUFFER, 
CBINIT, FREECORE, PROBDT 


Inner control blocks are built and the WRTBFR macro 
is issued to write data still in buffers. 


52 
See the explanation for a primary close in the note for 
step 12. 


53 IDA0200B: SHARE, SHAREDEQ 
DEQ is issued. 


54 IDA0200B: UPCATACB, UPCATDEQ ( calls 
IDA0192C), PROBDT 


55 IDA0200B: VMTPROC 
57 IDA0200B: UPSMF (calls IDA0192S) 


One SMF record type 64, is written for each AMB (for 
data set or index) connected to the ACB’s AMBL. 


See OS/VS System Management Facilities (SMF) for 
a description of SMF record type 64—Data Set Status. 


See “Data Areas” for details about the AMDSB, 
AMB, AMBL, and ACB. 


58 
See note for step 15. 


59 
See the explanation of a partial close in the note for 
step 12. If neither a partial nor a secondary close is 
being done, a primary close is being done. 


60 IDA0200B: DEHOOK 


The DEBCHK SVC is used. It removes VSAM DEBs 
from the TCB DEB chain. 


61 IDAO200B: 


{DA0192D destages data from the direct-access 
storage staging drive to mass storage. 


62 IDA0200B: CBRELE 
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Diagram AD6. VSAM CLOSE: Terminate Close Processing 


OO 


VSAM- or ISAM-User’s Address Space VSAM Close Processing VSAM- or ISAM-User’s Address Space 


63. Ifa dummy data set is being closed, unchain its 


ACB DEB ——— 
dummy DEB and free the dummy DEB’s — “aguing sar 

aaa a storage. = 

64. Reset the user’s ACB to its condition before it COLL OEE PE ACBDEB 

7 me 


65. Free work areas. 
Dummy DEB 


NNNANNNANNNNANNAN SC UNANANAAAAAAAANANAAANANAAAAAA 


ISAM-User’s Address Space OS/VS Close — Final Processing 


Reset to 
Conditions 
Before Open 


Error Flags 


66. Bypass access method executor processing for all 
VSAM ACBs being closed. 


67. Return to the caller or ISAM interface. 


SPP LLLL LL LL DLA ELL LS a” 


SYNAD 
Routines 


ISAM-Interface 
Processing 
Routines 


ISAM-Interface Close Processing — 


‘68. Delete the ISAM-Interface control blocks and 
buffers that allow the ISAM-user’s program to 
read and write records in a VSAM data set. 


69. Reset the DCB so that it can be opened again. | 


R15 
2 reco 


OS/VS Close — Final Processing 
70. Return to the ISAM-user’s program. 


Lg uonelodg Jo poywop 


C i 


Notes for Diagram AD6 IFG0200W sets the identifier for each VSAM ACB 


sian ee eee ee entry in the WTG table to 0. 

. ; : IFGO200Y sets the identifier for each VSAM ACB 
IDA0200T calls IDA0192C entry in the WTG table to C‘2L’, the identifier of the 
If a catalog is being closed, IDA0192C issues a dummy OS/VS Close Final Termination routine. 
LOCATE to indicate that the closing of the catalog is IFG0202L sets the return code in register 15. 

lete. 

aaa See “Diagnostic Aids” for details about the VSAM 
Unless a dummy data set has been closed (see note Close return codes and error codes. 


between notes for steps 4 and 6), a DEQ parameter list ’ : 
is built and a DEQ Is issued for every data set ISAM Interface Close Processing (continued): 


associated with the user ACB. The parameter list 68 IDA0200S: FREEBFRS, FREEDEB, RESETDCB, 
indicates “SYSVSAM” as the major resource and FREEWA, FREEMAIN 
control-interval number of the data set, catalog ACB 


address, and ‘B’ (busy) as the minor resource. The ISAM Interface Close routine releases the virtual 


storage obtained for the ACB, the IICB, the DEB, the 


64 IDA0200T: RESTORE RPLs, and the ISAM Interface buffers. 
The ACB condition before it was opened is: 69 IDA0200S: RESETDCB 
e Open bit (ACBOFLGS) is off The DCB conditions before open are: 
« Address of the VSAM interface routine ¢ DCBOFLGS: Open bit off, Lock bit off (set to 1), 
(IDAO19R1) is 0 and Busy bit off 
e Address of the AMBL is 0 « DCBDSORG: ISAM-Interface bit off 


« DDNAME field contains the DDNAME from the 
TIOEDDMM field in the TIOT DD entry 


65 IDA0200T: FREECORE 


The storage for the close work area and the module 
work area is freed. 


66 IDA0200T 


The VSAM Close routine sets the ACB’s open bit 
(ACBOFLGS) off if the ACB is closed successfully. If 
an error occurs while closing an ACB, the VSAM 
Close routine or OS/VS Close sets the appropriate 
error flag. 


The VSAM Close routine returns control to OS/VS 
Close by putting the identifier of the Close Final 
Termination routine, X‘2L’, in the WTG table and 
transferring control (through the IECRES macro 
instruction) to the O/C/EOV resident routine. The 
resident routine examines the close parameter list and, 
if all ACB entries have been processed by the VSAM 
Close routine, returns to the OS/VS Close Final 
Termination routine. If not, the next ACB entry in the 
close parameter list is processed (return to step 4). 


OS/VS Close modules (IFGO0200W and IFGO200Y) 
ensure that an ACB entry in the close parameter list is 
not processed by any access method executor routine. 
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Diagram AE!. VSAM End-of-Volume: Obtain the VSAM Object’s Next Volume 


Note: An “object” can be a VSAM data set, index, 
catalog, or catalog recovery area. 
VSAM Record Management routine 


OS/VS EOV Initial Processing 


Virtual Storage Obtained for 
VSAM Record Management 


AMB 


Work Area 


Alternate 
TCB TIOT 


1. Is the-object a VSAM catalog or 
catalog recovery area? 
No Yes 


t Alternate 
TIOT 


2. Modify the JFCB and build an 


Alternate TIOT entry to allow eat a 
VSAM EOV to process the VSAM Catalog 


catalog as a key-sequenced data set. 


RBA or Key 


3. Is this a request to update the catalog? 
No Yes 


4. Update the data set’s AMDSB 

in the catalo, > 
Virtual Storage Obtained for ‘VSAM End-of-Volume: Virtual Storage Obtained for 
VSAM End-of-Volume y Locate and Mount the Object’s Next Volume End-of-Volume Work Area 
5. Identify the volume that contains the caller- Volume Serial Number 
specified RBA or key value. (See Diagram DE 1, 
For Extent “LOCATE: Retrieve Catalog Information.’’) 


Information . Mount the volume identified in Step 5. 


Device Type 


Extent Information 


Serial Number of Object’s 
Next (Candidate) Volume 


For Volume 


CTGPL 


Serial 7. Is more space to be allocated to the object? 
To Retrieve Numbers A = Yes No 
by eam For Object’s / 
atalog Allocation 
Cc ] 
Record Requirements @ pe 


“Demount Volume [XXXXX1] 
Message from Unit [YYY]” 
to Operator “Mount Volume [XXXXX2]| 


Allocate additional space to the object 
: on Unit [YYY]”’ 


. Can the object’s allocation requirements be met 
by the available space on the currently mounted 


VSAM Catalog volume? 


Object’s 
Catalog 
Record 


Volume 
Catalog 
Record 


. Is the additional space for one of the data set’s 
or catalog’s key-ranges? 
No Yes 
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Notes for Diagram AE1 


Diagram AE1 describes VSAM end-of-volume (EOV) 
processing. VSAM end-of-volume is called by OS/VS 
EOV when SVC 55 is issued by VSAM Record 
Management routines. VSAM end-of-volume provides 
these services: 


When the GET routine detects that the requested 
record is not on any of the currently mounted volumes 
for the data set, a volume is demounted, if necessary, 
and the volume that contains the requested record is 
mounted. 


When a PUT request cannot be completed because 
there is no more space in the object, additional space 
is allocated to the object. The amount is based on the 
object’s space allocation requirement. If enough space 
is available to satisfy the object’s space allocation 
requirement, the space is allocated from the free space 
in: 


First, the VSAM data space containing the object. 


— Next, the volume containing the object. If an 
object's key range is assigned more space, space is 
allocated from the volume containing the key range 
if the object has not been assigned an overflow 
volume. Otherwise, (for key range only) space is 
allocated from another volume that has been 
assigned to the key range’s object as an overflow 
volume. 


— Finally, another VSAM volume that has been 
assigned to the object as a candidate volume. 


IGCOOOSE, IFGOSS1IF 


If register | addresses an AMB (for VSAM EOV 
processing), the OS/VS EOV routine sets the ID field 
in the where-to-go (WTG) table to C‘7A’, the 
identifier of the VSAM EOV routine. The WTG table 
built for an EOV request contains only one entry. All 
further OS/VS EOV routines are bypassed. 


IFGO550Y 
IDA0557A 


The request is either to handle an end-of-volume 
condition or to update information in the catalog. 


IDA0557A: CATUPD (which calls IDA0192C) 
The AMDSB contains statistics for the data set. 
IDA0557A: VOLLOC (calls ARDBSCH) 


The volume information sets of fields (in the object’s 
catalog record) contain the volume serial number of 


C 


each volume (used or candidate) assigned to the 
object. The volume information sets of fields also 
contain the low and high key values of each key range, 
and the low and high RBA values of each extent in the 
object. 


If the end-of-volume request is for more space on the 
currently mounted volume, the volume’s serial number 
is in the end-of-data ARDB. 


IDA0557A: VOLLOC (calls VOLMNT) 


The VSAM Volume Mount and Verify routine 
(IDA0192V) confirms that the specified volume is 
mounted. If no device is available for the volume, the 
VSAM Volume Mount and Verify routine requests 
that the operator demount a volume not in use. If all 
devices contain volumes currently in use, the VSAM 
Volume Mount and Verify routine sets the 
volume-not-mounted return code and returns to the 
caller. 


IDA0557A: ALLOCSPC 


If the AMB’s allocate-space request option indicator is 
on, the VSAM end-of-volume routine gets more space 
for the object. 


See “‘Data Areas” for details about the AMB. 
IDA0557A: ALLOCSPC (calls (CATALC) 


The volume catalog record defines a VSAM direct 
access volume in terms of the objects it contains, the 
VSAM data spaces it contains, and the available (free) 
space in each of it’s data spaces. 


See “Data Areas” for details about the volume catalog 
record. 
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Diagram AE2. VSAM End-of-Volume: Obtain the VSAM Object’s Next Volume 


Virtual Storage Obtained 


for VSAM End-of-Volume (9) Allocate additional space to a key-range 


Volume Serial 10. Mount the overflow volume assigned to the 
Numbers ne id key-range. 


Extent 
Information 


Sa Sri, Obtain an amount of space based on the key-range’s 
space allocation requirements. (See Diagram DI1, 
“UPDATE-Extend: Obtain Additional Space for 
a VSAM Object.’’) 


Freespace 
Information 


mpeate Date 12. Can the available space on the overflow volume VSAM Catalog — Data Set 
satisfy the space allocation requirements of the = ——— 
Virtual Storage Obtained key-range? Updated 
for End-of-Volume No Yes Data Set 
Catalog 
Record Data Set 
CTGFLs Allocate additional space to an object Bee ee sae aa = Freespace 
For Data Set’s 13. M bj ’ : ; Extent New Extent 
Pot Volume AD . Mount the object’s candidate volume in place of togl 
Catalog TF the volume mounted in step 6. Data Set 
Record For Data 


Set’s Extents 


14. Obtain an amount of space based on the object’s 
on Volume 


space allocation requirements. (See Diagram DI], 
“UPDATE-Extend: Obtain Additional Space for 
a VSAM Object.’’) 


Virtual Storage Obtained for 
Record Management 


Work Area 


Extent 
Information 
RBAs 
Freespace 
on Volume 
Volume 
Information 


Update system control blocks that describe the 
object’s space on the newly mounted volume. 


. Build a new DEB that contains a direct-access 
storage device section for each of the object’s 
extents on currently mounted volumes. 


Virtual Storage Obtained . Build an EDB for each extent (on the newly 
for Record Management mounted volume) associated with the object. 


Type of 17. Does the OS/VS system include the system 
Request management facilities (SMF)? SMF Data Set 


“X No Yes 


™ 18. Write SMF record type 64 — Data Set Status. 


¥ R15 
19. Return to the caller, ZB2ZZ2Z22H 


BO1 | BO1 
6 9 


Statistics 


C L L 
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Notes for Diagram AE2 
10 IDA0557A: VOLSW (calls CATLOCNC and VOLMNT) 


If the key range’s object has an overflow volume 
assigned to it, additional space for the key range is 
allocated from the overflow volume. If no overflow 
volume is assigned to the object, steps 8 through 10 
are bypassed and the space is allocated from the 
object’s candidate volume. 


IDA0557A: VOLSW (calls CATALC and CATUPDVO) 


The object’s catalog record describes its space 
allocation requirements. 


12 IDA0557A: VOLSW (calls CATLOCNC) 


If there is not enough available space on the overflow 
volume to satisfy the allocation requirements of the 
key range, space is allocated from the object’s 
candidate volume. 


13 IDA0557A: ALLOCSPC (calls VOLSW) 


If the volumes are full, and no other volume 
(candidate) is assigned to the object, the VSAM EOV 
routine sets the space-not-allocated return code and 
returns to the caller. 


See OS/VS2 SVS Independent Component: Access 
Method Services for a description of how candidate 
volumes are assigned to VSAM objects. 


14 IDA0557A: CATALC 


The object’s catalog record describes its space 
allocation requirements. 


1 


= 


See ‘‘Data Areas” for details about the catalog record 
details, and the volume information set-of-fields. 


15 IDA0557A: CTLBLK (calls DSCTLBLK) 


See “Data Areas” for details about the ACB and EDB. 


See OS/VS2 Data Areas for details about the DEB. 


The VSAM EOV routine builds a new DEB and EDB 
that replaces the existing DEB and EDB. The new 
DEB and EDB contain extent information that 
describe: 


¢ Each of the object’s extents (on currently mounted 
volumes) that was not affected by the EOV 
process. 


¢ Each extent that defines the object’s newly 
obtained space (if any). 


¢ None of the object’s extents on volumes that were 
demounted. 


C 


16 IDA0557A: DSCTLCLK (calls CATLOCXT and 
CATLOCRB) 


See ‘‘Data Areas” for details about the data set catalog 
record, the volume information set of fields, and the 
EDB. 


18 IDA0557A: SMFUPD (calls CATLOCDS) 


See OS/VS System Management Facilities (SMF) for 
a description of SMF record type 64. 


19 IDA0557A: TERM, PROBDET 


See ‘Diagnostic Aids” for details about the VSAM 
End-of-Volume return codes and error codes. 


If an error is detected, the VSAM End of Volume 
routine attempts to determine the type of error and 
builds a message describing the error. 
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Diagram AF1l. BLDVRP/DLVRP: Build or Delete a VSAM Resource Pool 


Register 2 Build a Resource Pool 


tBLPRM 


. Check the validity of the parameter list. 
wee . If there is no valid-AMBL table, build one. 


— 
oe 2 . Build the VSAM shared resource table. 
ee Fe 
'B . Build a working storage headcr and CPA header. 
uffer \ 
Subpool : 
List ‘\ . . Build a pool of placeholders. 
\ . Build the buffer subpools requested. 
Buffer Subpool List \ 
\ . Return the caller. 
N“\ 
\ 
s\ 
N“\ 


Delete a Resource Pool 
8. Check the validity of the parameter list. 


9. Is there a VSAM shared resource table? 
No Yes 


10. Unchain it from the valid-AMBL table. 2>(C) 


11. Free all storage used for the resource pool. 


12. Return to the caller. 


JSCB VAT 


JSC BSHR 
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Notes for Diagram AF 1 
BLDVRP 
1 IDA0192Y: DBDCVAL 


BLPRM is the BLDVRP parameter list. There must be 
no conflicting parameters, and buffer sizes must be 
valid. 


IDA0192Y: BLDVAT 
IDA0192Y: BLDVSRT 


The VSAM shared resource table is initialized to 
receive pointers in subsequent processing. The control 
block structure for processing with shared resources is 
illustrated in “‘Contro] Block Interrelationships”’ in 
“Data Areas.” 


IDA0192Y: BLDWSHD 
IDA0192Y: INITPLHP 

IDA0192Y: BLDBUFC 

IDA0192Y: BLDVRP 


The address of the VSAM shared resource table is put 
into the valid-AMBL table. If this chaining couldn't be 
done, the DLVRP procedure gets control to delete the 
resource pool. 


8 DLVRP 


There must be no conflicting parameters and no ACBs 
optn to use the resource pool. If an ACB ts open to use 
it, the DLVRP is rejected. 


If DLVRP is issued without a previous BLDVRP, 
there is no VSAM shared resource table. 


10 IDA0192Y: DELVRP 
11 IDA0192Y: FREEVSRT 
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Diagram AGI. VSAM Checkpoint: Checkpointing VSAM Control Blocks 


T VCRWA 


1. Obtain storage and initialize VCRWA. 
ACB 


JSCB 
VA } 
AMBL’S 
————> 2. For each VSAM data set: 
=! ° ° 
ree 
= | 


ACB a 


VCRT'S 


7? “N 
7 ‘\ ey a. Build VSAM checkpoint/restart table (VCRT). 
™ === = > b. Issue CLOSE TYPES=T to complete I/O and 
flush buffers. 
c. Perform VSAM reposition processing as 
required. 


d. All VSAM data sets processed. 


Yes No 
VSAM VSAM 
Data Data 
Sets Sets 


3. Return to IGC 0206C. 
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Notes for Diagram AG1 


IDAOCO6C receives control from IGCO0O206C via 
BALR14,15. 


1 Obtain and initialize VCRWA. The JSCBSHR field is 
saved in the VCRWA so that VSAM restart can 
restore it. 


2 For each VSAM data set, build a VCRT and chain to 
the primary AMBL’s BIB (each VCRT points to the 
VCRWA), issue CLOSE TYPE=T, and perform 
reposition processing. The current CI is gotten from 
the data set and is reflected to the restart half of 
checkpoint/restart. 


7 Control returns to IGCO206C. 
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Diagram AH1. VSAM Restart: Rebuild VSAM Control Blocks 


R2 ACB or AMB JSCB VAT AM BL 
: 1D 71. Restore address of VAT in JSCBSHR. pepper rrr2d 
tAMBL Pa 
7 
go 4 2. For each open and upgrade entry. 
AMBL VCRWA Pa / : ; ; BIB 
7” / N sa. Free all fixed string and fixed upgrade string 
t BIB tVAT / e A HEB’s. BRA PPPPAPLLASIOPPIPLP PPP POO 1 Free HEB eam >. O) 
/ > 


fy ‘ b. Free the VSAM subpool 253 IRB from the 
BIB / () data set DEB. 
/ : © CMB HEB PFL 


tVCRT J / c. Rebuild all PFL’s and their associated CMB 
yi / strings which describe storage locations. pea —_—- 
y, / 
/ 
F y, / 3. Issue CIRB to obtain model IRB in caller's key 
P. Z and state. ZLZZZZZZZELZZZZEEEEEEEBD| 001001 253 PEA 


/ 
tUpd 4 / 
; 


/ Data AMB DEB 


IRB 
Subpool 254 


/ / 7 4, For each open upgrade entry, issue GETMAIN 
2°71 for VSAM IRB's in subpool 254 and copy contents 


a“ of model IRB to getmained IRB. CZ2LLZLLLLLDP 


* AMBL Index AMB 
= tACB 
ad 
= 
~~, 


> For each open and update entry. rebuild all VSAM ACB Dummy DEB 


. _-? 5. 
Update Entries AMBL (cy dummy DEB’s in subpool 252 and add them in a Subpool 252 
+CMB the DEB chain. 


One 
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Notes for Diagram AH1 


VSAM restart 


1 IDAOAOSB restores the address of the VAT in the 
JSCB. IDAOAOSB is called from IGC“AOSB. 


2a IDAOAOSb: INITLSQA,FREEHEBS. 


For each primary AMBL, free all fixed string and 
fixed upgrade string HEBs associated with ais VCRT 
open and upgrade entries. 


2b IDAOAOSB: INITLSQA,FREEIRBS. 


For each primary AMBL, free all subpool 253 IRBs 
associated with all VCRT open and upgradc entries. 


2c IDAOAOS5B: INITLSQA,BUILDBLK. 


For each primary AMBL, rebuild all PFLs and their 
associated CMB HEBs. Open module IDA0192M is 
called to obtain the storage. 


2c IDAOAOSB: INITLSQA,BUILDBLK. 


For each primary AMBL, rebuild all PFLs and their 
associated CMB HEBs. Open module IDA0192M is 
called to obtain the storage. 


3 IDAOAOSB: INITLSQA,GETIRBS. 


Obtain a model IRB via CIRB in the caller’s key and 
state, and reconstruct all VSAM DEBs in subpool 254. 


5 IDAOAOSB: INITLSQA,GETDEBS. 


Rebuild all VSAM dummy DEBs in subpool 252. The 
DEBs obtained by VS restart are freed. 
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Diagram AH2. VSAM Restart: Rebuild VSAM Control Blocks 


VCRWA 


A” 6. Get core for RWA (this includes restart ACB’s) and Eeg@) TRWA 


8. Build VCRT upgrade entries for restart. 


i chain VCRT, VCRWA, and RWA. 
/ 
/ VCRT 
U pgrade / 
tte / i 
/ 
/ Restart 
/ __ _ —— —™ 7. Build and open restart ACB’s and update VCRT B® AMBL 
w open entries for restart. Z Open Entry 
\ Z Ee aed 
\ 4g 
\ 2 
OLD? AMB 
7 Z 
oz ® [ 
Upgrade Entry 


“ 
>| |% 
= 
ey 
om 


N 9. Update user ACB and AMB TIOT offset and Bag a 
AMDSB 


\AAAANAANAANAAAANAARAARANA . 


catalog ACB pointers. Z 
y 
7 
SSS > 10. Check for data set (catalog) modified error. Z AMB 

&. 

SPLSA SALAS ALAS LS SS 

11. Pass control via call to VSAM restart 2nd load. ae Y 

Z 
Uy Restart 22 LLL LLL LDL 
ECB 


12. Close all restart ACB’s open for current data set 22ZZap> 
being processed. 


f 
13. Free VCRT. VCRWA. and all storage gotten by ~~ 4@)) 
VSAM restart. 


VSAM Catal 
one 14. Return to IGC OAOSB. 


Return via BR 14. 


c c 
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Notes for Diagram AH2 


VSAM Restart 
6 IDAOAOSB: INITLZ 

Get storage for the restart ACBs, RWA, and RPL. 
7 IDAOAOS5B: OPENACB 


The restart ACBs are opened, and the VCRT open 
entries are updated to reflect the locations of the 
restart AMBLs and ACBs. 


8 IDAOAO0SB: UPGRADE,UPDATE 


The immediate upgrade entries are built, and the 
VCRT upgrate entries are updated. The catalog ACB 
address and AMB/ACB TIOT offsets are updated to 
reflect restart time pointers. 


11 IDAOAOSB: 


Restart load 2 (IDAOBOSB) is called to complete 
repositioning or data set verification. On return, close 
all restart ACBs, free restart work areas, and return to 
IGCOAOSB. IGCOAOSB will XCTL to VS restart 
module IGCOVOSB. 


d130°] (INVSA) POU? SS999Y adeJOIG [ENA :jUoUOdWIOD JUapuadapuy SAS ZSA/SO OL 


Diagram All. VSAM Restart: Rebuild VSAM Control Blocks 


Restart CMB 


MY 


. Call PREFORMAT procedure if required to 


Restart AMDSB 


Restart ARDB Pi 


oe 


Restart HEB’s 


8. 


. Call VERIFY procedure if required to obtain 


VSAM 
Data Set 
reposition data set. 


current high water mark. 


. Call PUT (data) procedure if required to reposition * 
data set. 
. Call PUTLX (index) procedure if required to 
reposition index set. 
User AMDSB 
. Call COPYRTN procedure to update user control 
blocks. 
User ARDB 
User CMB 
User HEB’s 


. Call HEBSWAP procedure to swap certain header 


element blocks. 


. Call PAGEFIX procedure if required to pagefix 


VSAM control blocks. 


Return to IDA OAOSB. 


WY 


L U 


[LZ Uonessdyo Jo poylep] 


C 


Notes for Diagram AI1 


1 


IDAOBOS5B receives control from IDAOA05B 
IDAOB0O5B: PREFRMAT 


PREFRMAT is called if reposition is required (create 
mode KSDS or ESDS output CRPS = NCK,NRE, or 
speed not specified and data set has been used). 


IDAOBOSB:VERIFYHU 


If data set is not in create mode and the immediate 
upgrade data sets exist or if data set is KSDS/RRDS, 
call VSAM VERIFY to obtain current high used RBA 
for data set. 


IDAOBOSB:PUTRTN 


Call VSAM PUT to rewrite the data CI for ESDS 
(noncreate mode) data sets that require repositioning. 


IDAOBOSB:IDXPUT 


Call VSAM PUTIX to rewrite the highest index CI of 
each index level that existed at checkpoint time. 


IDAOBOSB:COPYRTN 


Copy, the restart AMDSB and ARDB to the user's 
AMDSB and ARDB respectively, and also swap the 
restart AMB DEB and EDB pointers with the DEB 
and EDB pointers in the users AMB. 


IDAOBOSB:HEBSWAP 


Swap certain user HEBs with restart HEBs. The HEBs 
to be swapped are the protected string, the DEB 
blocks, and the EDB blocks. 


IDAOBO5B:PAGEFIX 
Perform page fix if ICIP with page fix option specified. 
Return to IDAOAOSB via BR 14. 
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Diagram BAI. Record Management Table of Contents 


PUT Macro 
Processing 
(Entry 
Sequenced) 
Diagram BE1 


GET Macro 
Processing 
(Sequential) 
Diagram BD1 


GET Macro 
Processing 
(Direct) 
Diagram BC]! 


Creating a Key-Sequenced Data Set 


PUT Macro 
Processing 
(Key 
Sequenced) 
Diagram BF 1 


Getting a New 
Control Interval 
Diagram BGI 


Getting a New 
Control Area 
Diagram BG2 


Creating 
Index Records 
Diagram BG3 


Updating an 
Index Structure 
Diagram BG4 


Creating or Modifying a Relative Record Data Set 


PUT or ERASE 
Macro Processing 
(Modify) 
Diagram BO2 


PUT Macro 
Processing 


(Insert) 
Diagram BO! 


ERASE Macro 
Processing 
Diagram B11 


PUT Macro 
Processing 


(Insert) 


Diagram BHI 


Inserting an 
Index Entry 
Diagram BH6 


ISAM 
Interface 
Diagram BU1 


VSAM 
Overview 


Diagram AB1 


EN DREQ 
Macro 


ENDREQ 
Macro 
Processing 
(Create) 
Diagram BK2 


POINT Macro 
Processing 
Diagram BJ1 


Processing 
(Noncreate) 
Diagram BKI1 


Modifying a Key-Sequenced Data Set 


PUT Macro 
Processing 
(Modify) 
Diagram BH2 


GET or GETIX 
Macro Processing 
Diagram BN1 


Creating 
Space for 
Insertions 
Diagram BH3 


MRKBFR Macro 
Processing 
Diagram BP1 


Splitting a 
Control Area 
Diagram BH4 


Updating 
the Index 
Structure 
Diagram BHB 


Major Subroutines 


Upgrading 


Processin 
B an Alternate 


a Path 


Splitting an 
Index Record 


Index 


Diagram BQ! Diagram BRI 


Diagram BH9 


VSAM 
Request 
Processing 


Diagram BB1 


CHECK Macro 
Processing 
Diagram BL1 


PUT or PUTIX 
Macro Processing, 
(U pdate) 
Diagram BN3 


VERIFY 
Processing 
Diagram BM1 


Processing by Control Interval 


PUT Macro 
Processing 
(Create) 
Diagram BN2 


Processing with Shared Resources 


WRTBFER Macro 
Processing 
Diagram BP2 


Buffer 
Management 


Diagrams 
BS1, BS2, BS3 


SCHBFR Macro 
Processing 
Diagram BO3 


WO 
Management 
Diagram BTI 
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Diagram BB1. VSAM Request Processing 


Register 0 _? 1. Is the request a CHECK or ENDREQ? 


- 
Pa 
N . 
User’s Virtual Storage \ User’s Virtual Storage 
5 
\ 


\ 
N 


\ Common Initialization of Request Processing 


. Initialize the RPL(s) in the request-string. eae 


. Assign a placeholder to the request-string. BaZa ezezZeezzZZIZ 


\ 


AAAAAAAAAAAAAAAN 


. Ensure that the request is consistent with the 
data set’s characteristics. 


PLH(s) 


“ 


. Initiate request processing. (Continued on Diagram 
BB2.) 


VSAM Record Management Processing by Request 
Type 


GET Macro Processing: 


for direct requests (RPL OPTCD=(DIR)) Diagram BC] 
for sequential requests (RPL OPTCD=(SEQ)) Diagram BD 1 


(See also “‘Control-Interval Access Processing.’’) 


PUT Macro Processing: 


for entry-sequenced data set processing Diagram BE]1 
for creating key-sequenced data sets Diagram BF 1 


for inserting records in key-sequenced data set 
for modifying records in key-sequenced data set 
for inserting records in relative record data set 
for modifying records in relative record data set 


(See also ‘‘Control-Interval Access Processing.’’) 


ERASE Macro Processing: Diagram BI] 
POINT Macro Processing: Diagram BJ 1 


C ‘e L 
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Notes for Diagram BB1 


2 


Several RPLs may be chained together to process 
more than one record with a single macro request. For 
example, a GET request associated with a chain of 
three RPLs returns three records to the user’s problem 
program. 


The number of placeholders is based on the STRNO 
parameter in the ACB control block. 


Each placeholder is examined to determine whether it 
is available for assignment to the request string. (Note: 
Once a placeholder is assigned to a request string, this 
association is fixed until an ENDREQ macro ora 
direct request that doesn’t require placeholder 
retention is issued against the RPL at the head of the 
request string. After the ENDREOQ or direct 
processing is completed, the placeholder is available 
for reassignment to another request-string.) 


When no placeholder is available in the list of 
placeholders for assignment to a request or request 
string, and resources are being shared or processing 1s 
loading a data set that was empty when it was opened, 
an error code is set and a return is made to the caller. 
Otherwise, IDA019R1 calls IDAXGLPH in module 
IDAOI19RU to obtain additional placeholders. If a 
placeholder is available, its identifier is placed in the 
RPL associated with the user’s macro request. 


If any of the following restrictions are violated, an 
error code is set in the associated RPL and the 
remaining RPLs (if any) in the request string are 
posted as incomplete: 


Keyed Request Errors 


Keyed requests against an entry-sequenced data set are 
not allowed. 


Requests based on a generic key must include a 
specified key-length value. 


Specified key lengths may not exceed the maximum 
key length value defined for a data set. 


Addressed Request Errors 


An addressed PUT-add request against a 
key-sequenced data set is not allowed. 


An ERASE request against an entry-sequenced data 
set is not allowed. 


C 


An address request against a relative record data set is 
not allowed. 


Control Interval Request Errors 


Control interval requests may not be issued against a 
data set unless the data set was opened for control 
interval processing. 
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Diagram BB2. VSAM Request Processing 


5. (continued) 


BB! | VSAM Record Management Processing by Request 
I Type (continued) 


ENDREQ Macro Processing: 
for request processing related to an old data set Diagram BK 1 


for request processing related to a newly created 
data set Diagram BK 2 


CHECK Macro Processing: Diagram BL1 
VERIFY Processing: Diagram BM 1 
Control Interval Access Processing: 
for retrieving control intervals Diagram BN1 
for creating a data set Diagram BN2 


for updating control intervals Diagram BN3 
MRKBFR Processing Diagram BP 1 
WRTBFR Processing Diagram BP2 
SCHBFR Processing Diagram BP3 
Path Processing: 


for processing a request to gain 
access to a base cluster by way of 


User’s Virtual Storage an alternate index Diagram BQ! 
6. When the request is a CHECK or ENDREQ, return User’s Virtual Storage 
RPL(s) to the user’s ISAM problem program. 


Common Termination of Request Processing 


tTNext RPL 


Synch/ 
Asynch 
Flag 


. Reinitiate request processing until all RPLs in the 
request-string are processed. 


. When the request-string processing is synchronous, 
ensure that its processing is completed. 


. When another request-string has been deferred as 
a result of current request-string processing, pass 
control to the deferred request. 


aaa 

PLH 
Request- 
Pending 
Flag 


. Return to the module that issued the macro 
being processed. 


LL uowessdg jo poyj7w 
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Notes for Diagram BB2 


10 


When two request strings are competing concurrently 
for a serially reusable resource, the second string is 
deferred. 


When the deferred request is synchronous, a WAIT 
macro will have been issued against its ECB. When 
the DIWA is released by another request string, 
control is returned to a synchronous request at the 
point at which it issued the WAIT by module 
IDAOI9RS. 


It posts the request-string’s ECB to eliminate the wait 
condition. 


If an asynchronous request is deferred, a return 
address will have been placed in its placeholder, and 
when the serially reusable resource becomes available, 
a branch is made to that address. 
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Diagram BC1. GET-Direct Processing: Direct Retrieval 


VSAM 

Index 

Venn 1. Locate the data control interval containing the Register RWORK2 
Data user-specified key, RBA, or relative record number RBA of Data 

Set and place the control interval in a data buffer. = Control Interval 


So 


2. Is the record a spanned record? 
No Yes 


3. Move all segments of the record to the 
user’s area. 


VSAM User’s Virtual Storage 


Output of ; 
eles ——— ? 4. Move the record associated with the user-specified 
VSAM User's Virtual Storage key, RBA, or relative record number into the 


user-specified record area. 


tSearch 


Argument [)  ~=‘|Step4 9 FR77—777 > 5. When the contents of the buffer are not needed 


ee by the next request, release the buffer. 


VSAM Buffer 


Data Control Interval 


User Record Area 


| recors WY 


tUser Area 


Relative Record 
Number 


Key. RBA, or - a Return to caller. 


User’s Record Area 


6L UOoTeladg jo poylaw 


Cr 


Notes for Diagram BC1 
1 Keyed Processing-Key-Sequenced Data Set 


IDAO19RA 


When the request is keyed, an index search must be 
performed. The index level where the search begins is 
based on the following considerations: 


¢ For skip-sequential processing, the index search 
starts at the sequence set—normally at the index 
record pointed to by the current PLH. If the PLH is 
invalid, the search starts at the first record in the 
sequence set. 


¢ For direct processing, the search starts at the 
highest level of the index. 


IDAO19RA calls IDA019RB, which calls IDA019RZ 
(IDAGRB) 


The index record at which the search is to start is 
moved into an index buffer. 


IDAO19RB calls IDAO019RC 


The index record is searched for an entry that is 
greater than or equal to the search key. 


IDA019RB 


When the search is unsuccessful, the next record in 
logical sequence is searched. If the search is successful 
and a lower index level exists, the search is performed 
on the index records in the lower level. 


Keyed Processing—Relative Record Data Set 
IDA019RR 


The relative record number that is specified as a 
search argument is converted into the RBA of the 
control interval that contains the record and the offset 
of the record in the control interval. 


IDA019RR calls IDA019RZ (IDAGRB) 
The control interval is read in by RBA. 
Addressed Processing 

IDAO19RA 


The RBA that is specified as a search argument is 
converted into the RBA of the boundary of the control 
interval within which it falls. 


Doesn’t apply to a relative record data set. 
IDA019R4 calls IDA019RT (IDADARTY) 


A spanned record is delivered. 


Cc 


IDADARTYV calls IDA019RZ (IDAFREEB) 


A segment is moved to the user’s area. The buffer is 
freed. 


IDADARTYV calls IDA019RZ (IDAGNXT) 
The next segment is obtained. 
IDA019R4 


If the user is performing locate processing, the address 
of the record is moved into the user area. If the 
request is for update and an upgrade set exists, 
IDAO19RU is called to save the LLOR (least length of 
record that contains the prime key and all alternate 
key). (See Diagram BR1.) 


Relative Record Processing 
IDA019RR 


If the user is performing locate processing, the address 
of the record is moved into the user area. 


IDA019R4: RLSEBUFS calls IDAO19RZ 


If the request is direct and update, 
note-string-position, or locate mode processing 
options is not specified, the contents of the buffer are 
not needed by the next request and the buffer is 
released. If the user’s processing with shared 
resources, any index buffer is freed. 


Relative Record Processing 


IDAO19RR calls IDA019RZ (IDAFREEB) 


If the request is direct and update, 
note-string-position, or locate mode is not specified, 
the buffer is released. 
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Diagram BD1. GET-Sequential Processing: Sequential Retrieval 


BB1 
VSAM User’s Virtual Storage VSAM User’s Virtual Storage 


P 


Data Buffer 


LH 


— ee —— — — > 1. When the desired control interval is not already in 
Flag the data buffer as a result of processing related to 
Record a prior request in the current sequence of requests, 
Position WT esi: place the control interval in a data buffer. 


~~} re 
2. Advance the placeholder to position to the record 


: R d 
logically following or preceding the record LLL ALD OL SLY, 


Data Buffer 
Data 
Record 


RPL 
Address of 
User Area 


associated with the prior request in the current 
sequence of requests. 


3. Is the record a spanned record? User Area 


No es Precors | 


4. Move all segments of the record to the ae 
user’s area. EE (6) 


_—_—— —>» 5. Move the record positioned to by step 2 into the 
user-specified record area. 


6. Return to caller. 


® BB2 
7 


VSAM 
Data 
Set 
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Notes for Diagram BD! 


Key-Sequenced or Entry-Sequenced Data Set 
IDA019R4 

Forward Processing 

IDA019R4: ADVPLH 


Normal GET-sequential processing advances the 
record pointer to the next record in RBA sequence in 
the data buffer. 


If the record pointer points to the end of a control 
interval, the following processing is performed: 


IDA019R4 calls IDAO19RZ (IDAFREEB) 
The current buffer is released. 
IDAO19R4 calls IDAO19RZ (IDAGNXT) 


The next control interval is retrieved. If the next 
control interval contains all free space, the retrieval 
process continues until a control interval containing 
data is acquired. 


Backward Processing: 
IDA019R4 calls IDAOISRV (IDAADVPH) 


Normal processing advances the record pointer to 
preceding record in RBA sequence in the data buffer. 


If the record pointer points to the beginning of a 
control interval, the following processing is 
performed: 


IDAADVPH calls IDA019RZ (IDAFREEB) 
The current is released. 

IDAADVPH calls IDAO19RZ (IDAGNXT) 
The preceding control interval is retrieved. 
IDA019R4 calls IDAO19RT (IDADARTY) 

A spanned record is delivered. 

IDADARTYV calls IDAO19RZ (IDAFREEB) 


A segment is moved to the user’s area. The buffer is 
freed. 


IDADARTYV calls IDAO19RZ (IDAGNXT) 
The next segment is obtained. 
IDA019R4: DATARTV 


If the request is for update and an upgrade set exists, 
IDAOI9RU is called to save the LLOR (least length of 
record that contains the prime key and all alternate 
keys). (See Diagram BR1.) 


C 


Relative Record Data Set 


1 


IDAO19RR 
The data buffer contains the current control interval. 
IDAO19RR: ADVPLH 


The record pointer is advanced for normal sequential 
processing or backed up for backward sequential 
processing. If the record pointer points to the end of 
the control interval for normal processing, or the 
beginning of the control interval for backward 
processing, the following processing ts performed: 


IDAO19RR calls IDAO19RZ (IDAFREEB) 
The current buffer is released. 
IDAOI9RR calls IDAO19RZ (IDAGNXT) 


For normal processing, the next sequential control 
interval is retrieved, and the record pointer is set to 
the first record. For backward processing, the 
preceding sequential control interval is retrieved, and 
the record pointer is set to the last record. 


IDAO19RR 
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Diagram BE1. PUT-Entry-Sequenced Processing: Create or Insert at End of Data Set 


BB1 
5 
i 


> VSAM Buffer 


_—— 1. Ensure that the current output buffer is positioned 


to the end of the data set and prepared to receive 


VSAM a new record. 
Dat : 
oe ? 2. If an upgrade set exists, upgrade the alternate Recor a, ee Space 
ey indexes in it. (See Diagram BR1.) 
= Unused Space —> 3. Is the record to be inserted a spanned record? VSAM Buffer 
No ~ 


ecg sed 4 and § for each segment. 


RPL Record Length 


— 3@ 


User’s Record Area 


=ty / 


6. When there is insufficient space to contain the new 
JA record, get the next control interval. 


New Record eer eee ee et 7. Move the new record into the data control 
Lf interval. 


BUFC / . As control intervals are filled, write them to the 


5 / data set. VSAM 
Data 

@ 9. Return to caller. a 

/ 


Unused Ss 


VSAM Buffer (Available) 


BB2 
7 
Output 
of Step 7 
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Notes for Diagram BE1 
1 Create Mode Processing 


IDA019R4: SQICHECK calls IDAO19RZ (IDAGNNFL) 


When processing is in create mode and the current 
request is the first request after opening the data set, a 
buffer is assigned to the request. 


IDA019R4: SQICHECK 


The buffer is initialized and buffer output is positioned 
to the first control interval associated with the data 
set. 


Add-to-End or Mass Insert (Noncreate) Processing 


IDA019R4: GETINCI calls IDAO19RA 


The address of the desired control interval is 
established by GETINCI, and IDAO19RA determines 
whether the control interval in the current data buffer 
has that address. When it does not, excess buffers are 
released (IDAOI9RA calls IDA019R2 (IDASBF)) and 
the desired control interval is moved into the buffer 
(IDAOI9RA calls IDA019R2 (IDAGRB)). 


IDA019RH calls IDAO019RU 
IDA019RM calls IDAO1I9RT 


If the buffer is not empty, IDAO19RT calls IDAO19SA 
to obtain an empty buffer. 


IDA019RT 


The record segment is moved to the buffer, and the 
CIDF and RDFs are built. 


IDA019R4 calls IDAO19RM 


When there is insufficient space to contain the new 
record, IDA019RM calls IDA019SA and the following 
processing is performed: 


IDA019SA calls IDA019RZ (IDAFREEB) 
The current data buffer is released to be written. 
IDAO019SA: EOCA 


When no more control intervals in the current control 
area can be used, IDA019SA calls IDA019RZ 
(IDAWRBFR) to ensure that all output to the current 
control area is completed. Then, after positioning to 
the next control area boundary, a test is made to 
determine whether the new control area address 
exceeds the limits of the data space allocated to the 
data set. If the data space is exceeded, IDAOI9SA 
(EOCA) calls IDA019R5 (IDAEOVIF) to issue an 


Cc 


SVC 55 in order to allocate additional extents to the 
data set. 


IDA019RM 


Before moving the record into the control interval, an 
RDF is created for the new record. 


Actually, this process occurs at step 6. It is not 
determined that a control interval is full until an 
attempt is made to insert the next new record. 


M30] (NVSA) POUL Ssed9y a3elOIg [eNIA :JUoUOdWIOD JUspusdspu] SAS ZSA/SO +8 


Diagram BF1. PUT-Key-Sequenced Processing: Create 


ed 


VSAM User’s Virtual Storage VSAM User’s Virtual Storage 


1. When this is the first request after Open, assign a paxyaer> 
data buffer to the request. 


2. Is the record to be inserted a spanned record? 
No Yes 


Ow 


3. Process the spanned record segment by 


SCoM1 CN. > () 


4. Move the new record into the current data buffer 
and build/update an RDF. (See Diagram BG] for 
a description of processing when the freespace in 
the current control interval is inadequate or 
when the current key range is exceeded by the 
key of the new record.) 


Cu=> 5. Return to caller. 


BB2 
I 


Data Buffer 


New 


User Area 
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Notes for Diagram BF1 


1 


IDA019R4 calls IDAOISRZ (IDAGNNFL) 


The buffer control block entries are searched for an 
unassigned entry. The first unassigned entry found is 
assigned to the current request. 


IDAO019RM calls IDAO19RT, which calls IDAO19SA 


IDAOI9SA gets an empty buffer. IDAOI9RT moves a 
segment to the empty buffer. 


IDAO19R4 calls IDAOISRM 
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Diagram BGI. 


Creating a Key-Sequenced Data Set 


Get a New Freespace Control Interval 


VSAM User’s Virtual Storage 


LH 


Address of 
Data Buffer 


High Key 


Address of 
Index Buffer 


Index Buffer 


Current SS Record 


Data Buffer 


Current Data CI 


BUFCs (Data) 


pp Pare ae rape eg Se A ee a 


Available 
Status Flag 


. Create, in the sequence-set index record, an 


. Write the current data control interval. 


. Position to the next freespace control interval. 


. Return to caller. 


VSAM User’s Virtual Storage 


Index Buffer 


ee Se oa 
Se, a 


VSAM New Entry 
Data PLH 

Address of 

Data Buffer 


index entry for the current data control interval. 
(See Diagram BG3 for a description of 
index processing in support of the 
create process.) 


Assign a free data buffer to support 
continued processing. =. 


—_ 
—_ oe 
— 


(See Diagram BG2 for a description of 
processing when no more control intervals in the 
current control area can be used by the current 
request processing. ) 


— on, 
—— ese, 
—— seme 
= 


Data Buffer 
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Notes for Diagram BG1 


1 IDAOI9SA calls IDAO019RG 
2 IDAO019SA calls IDA019RZ (IDAFREEB) 


The buffer is made available for assignment to another 
request; however, the next request that attempts to use 
the buffer must first write the contents to the data set. 


3 IDAOI9SA calls IDAO19RZ (IDAGNNFL) 


The BUFC for the next available buffer must be 
written before it can be used. If the buffer must be 
written, a call is made to the I/O Manager, 
IDAO19R3, to perform the write operation, and a wait 
is performed to ensure that the I/O is completed. 
(Note: The IDAGNNEFL procedure is called when 
processing in create mode or when adding to the end 
of an entry-sequenced data set in update mode. Write 
operations for PUT-sequential processing are initiated 
only by IDAGNNEL.) 


4 IDAO19SA 
IDA019SA: EOCA 


More control intervals cannot be added to the current 
control area if the key of the last record in the last 
data control interval equals the high key of the current 
or only key range or if there aren’t enough freespace 
control intervals remaining in the control area to hold 
the new record and to maintain freespace 
requirements (that is, to maintain the number of 
freespace control intervals per control area specified 
by the user). 
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Diagram BG2. Creating a Key-Sequenced Data Set 
Get a New Freespace Control Area 


VSAM User’s Virtual Storage 
BU FC(s) 


Data Buffer(s) 


High-Used 
RBA 


. Write all completed and unwritten data control 


. When the nonrecovery option is specified, “i, 


. Establish the RBA of the next control area in 


. When the recovery option is specified 


. Return to caller. 


VSAM 
Data Set 


intervals associated with the current control 
area. 


index record, and place an entry for the index 
entry which was just written in a higher-level 
index record. (See Diagram BG4.) 


New SS Record 


preformat any unused control intervals in the 
current control area. 


physical sequence. (See Diagram AE] fora 
description of End-of-Volume processing when 
the next control area is not within the data 

space allocated to the current data set.) 


(SPEED=OFF), preformat the next control area. 
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Notes for Diagram BG2 


1 


IDAO19SA: EOCA calls IDAO19RZ (IDAWRBFR) 


Other than the current data buffer, all of the data 
buffers that have not been previously written are 
written to the current control area. 


IDAO19SA calls IDAO1ISRG 

IDA019SA calls IDAO1I9SRK 

IDAO19SA 

IDAO19SA calls IDAO19R5 (IDAEOVIF) 


The end-of-volume processor is called to allocate 
additional extent(s) to the data set if necessary. 


[IDAO19SA calls IDAO19RK 
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Diagram BG3. Creating a Key-Sequenced Data Set 


VSAM User’s Virtual Storage 


Current Key (K1) 
Previous Key (K2) 


P 


LH 
New Key (KO) 


Output 
Job Step 


I, 


. Build a complete entry in the current sequence-set 


VSAM User’s Virtual Storage 


Index Buffer 


. When this is the first entry in the index, obtain a | Header 


freespace control interval and initialize an index 
buffer. 


. Compress the new entry’s key. (See Diagram BG4 
for a description of processing when the index i 


entry won’t fit in the index record.) 


index buffer. 
Index Buffer 


. Return to caller. 
feof Tele] 
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Notes for Diagram BG3 


1 


IDA019RG calls IDAO1I9RN (IDAAQR) 


The index address-range-definition block (ARDB), 
which governs the range of keys that include the new 
index entry’s key, is located. The field in the ARDB 
that contains the address of the next available 
freespace control interval is placed in the index create 
work area (ICWA). 


IDAO19RG calls IDA019RZ (IDAGNFL) 
An index buffer is assigned to the request. 
IDA019RG: INTNEWRC 


The contents of the index buffer are set to 0 and the 
following items in the buffer are initialized to form an 
index record: header, dummy entry, CIDF, RDF, and 
freespace data control interval pointers (if the request 
is for a sequence-set record). 


IDA019RG: IDAIST 


Before the new entry’s key is compressed, the current, 
previous, and section key values in the ICWA are 
updated; the current key becomes the previous key, 
the new key becomes the current key, and the section 
key is updated if a new section entry has been built. 


The new key is compared with the previous section 
key, and a count of the common leading characters in 
the keys is set as a front compression value. (Note: 
The new key is front-compressed as if it were fora 
section entry even though it may not be. Because they 
front-compress less, section entries are slightly larger 
than normal entries.) 


When the current index record is a sequence-set index 
record, the current key is rear-compressed relative to 
the next data-record key, that is, the key of the first 
data record in the next data control interval. The next 
data-record key is in the record located by the 
RPLAREA field. 


The characters in the keys are compared from left to 
right until two corresponding characters in the 
respective keys differ in value. The current key is then 
truncated at this point. 


The length of the new entry is established, based on 
the compressed key and section pointer, F, L, and 
normal pointer field lengths. When there is inadequate 
unused space in the current index record to contain 
the new entry, a return is made to the caller, 
IDAO19SA, to obtain a new control area. (Note: 
IDAO19SA recalls IDA019RG to write the current 
index record and to create an entry for the newly 


r 


completed index record in a higher-level index 
record.) 


Section Entry Processing 
IDA019RG: IDAIST 


Move the F, L, and key values into the dummy entry, 
which becomes the new section entry. Then set the 
offset to the new dummy’s F field in the new section 
entry's LL field. (Note: The offset in the LL field is 
incremented by the displacement to each succeeding 
new dummy entry's F field until a new section entry is 
established. The process then repeats for each 
succeeding section entry until the record is filled.) 


When a previous section entry exists, it is linked to the 
new section entry by setting the displacement between 
the F fields of the new and previous section entries in 
the previous section entry’s LL field. 


When the insertion is to a sequence-set record or when 
an index-record split was just performed on the index 
record to receive the new entry, the next freespace 
control interval pointer in the index record is moved 
into the dummy record. (Note: A dummy record is 
always maintained as the highest possible key in the 
index during create processing in order to make the 
index complete and searchable even while it is being 
created.) 


When the new section entry is made in a high-level 
index record, the RBA of the current index record in 
the next lower index level is converted to an index 
entry pointer and placed in the dummy entry. (Note: 
There is an ICWA for each level of the index. Each 
ICWA has a field containing the RBA of the current 
index record at its particular index level.) When the 
current index record in the next lower level is 
completed, its high key will be placed in the dummy 
entry and this cycle continues. 


Normal (or Nonsection) Entry Processing 
IDA019RG: IDAIST 


The current key is front compressed relative to the 
previous key. The front compression performed in 
step 2 is based on the assumption that the new entry is 
a section entry. Only the rear compression performed 
for step 2 is valid in this normal, or nonsection, entry 
case. 


The key length is calculated and the F, L, and key 
values are moved into the new entry. 


C 


When a section entry has not been built, the section 
entry pointer in the index record header is advanced to 
point to the F field in the new dummy entry. 


When a section entry has been built, the LL field is 
incremented by the displacement between the new 
entry’s F field and the new dummy entry’s F field. 


See note 3, “Section Entry Processing,” for a 
description of how the dummy entry’s pointer is 
derived. 
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Diagram BG4. Creating a Key-Sequenced Data Set 
Insert an Index Entry for a New Index Record in an Index Record at the Next Higher Level 
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. Initialize the contents of the index buffer with 
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ptt Lg Dummy Pointers 


of the current sequence-set index record. 


. Write the current sequence-set record. 7) Index Buffer 
———<—<—<—_—____-v Freespace Control! Interval 


. Obtain a freespace index control interval. 


— 


index-record control information. A 


Header Y Lele D 1 
=| 
) ; 


Freespace 


processing, insert the entry that wouldn’t fit / / 
fy Cl Pointers / 


Dumm 
(see step 12) into the new high-level index record. ened 


Section 


/ / Entry 
- When this is the first time through this processing, es | ee, ene reniree / 


put the dummy entry’s pointer and base RBA in 
the new sequence-set record. C. . > 


. Write the new record. ise 
oy VSAM 
Data 
Set 
— ss : 
8 


See 
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Notes for Diagram BG4 


I 


IDAO19RG 


The base RBA is the RBA of the data control area 
controlled by the index record. During tndex create, 
the dummy entry points to the freespace control 
interval following the last control interval in the 
control area in which data records were inserted. At 
the end of index-create processing, the dummy points 
to the control interval containing the high-key record 
of the data set. 


IDAO19RG: calls IDAO1I9RJ (IDAWR) 


This operation overlays the index record that was 
generated by step 7 when this procedure was 
previously entered. 


IDAO19RG: calls IDAOI9RN (IDAAQR) 


The index address range definition block (ARDB) that 
governs the range of keys that includes the new index 
entry's key is located. The contents of the field in the 
ARDB that contains the address of the next available 
freespace control interval is placed in the ICWA. 


IDA019RG: INTNEWRC calls IDA019RZ (IDAGNFL) 


An index buffer is obtained, the buffer is cleared, and 
then it is initialized as a sequenced-set or a high-level 
index record. 


When the index record is high level (see note 5), a 
pointer to the lower-level index record just written (see 
note 7) is moved into the new higher-level index 
record as the dummy entry representing the highest 
key of the current level of the index. 


Steps 3 through 13 represent a repeating sequence of 
operations that retain control until an index entry is 
successfully inserted in an index record on the index 
level above the level on which a new index record is 
created. The first time through this code, processing is 
directed at the sequence-set level of the index. 
Subsequent iterations are directed at successively 
higher levels of the index. 


IDAO19RG: IDAIST 


The high key of the new lower-level index record is 
moved into the new higher-level index record built by 
step 4. 


C 


Dummy entries are maintained in all levels of the 
index as the highest possible key in each level in order 
to ensure that the index is complete, or searchable, 
even when it is being created. If the index is accessed 
while it is being created, an index search, no matter 
how high the key of the search argument, is always 
satisfied. 


For high-level index records (see note 4), the dummy 
entry points to the incomplete index record at the next 
lower level, and for sequence-set records, it points toa 
data control interval. 


IDA019RJ: IDAWR 


The new sequence-set or high-level index record is 
written to the data set. 


On a sequence-set level, this record points back to the 
data control interval in the control area belonging to 
the previous (just completed) sequence-set record and 
is maintained only to make the index complete. It is 
destroyed when the next sequence-set index record is 
completed and written to the data set (see note 2). 


On a higher level, this new record has an entry for the 
index record just completed on the next lower level 
and a dummy entry for the new incomplete record at 
that level. 
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Diagram BGS. Creating a Key-Sequenced Data Set 


Insert an Index Entry for a New Index Record in an Index Record at 
the Next Higher Level (continued) 


PLH 


te Freespace A 


ICWA (High Level 


Index Buffer 


Le 


ICWA (Sequence 


Address of 
ICWA for 


Next Level 


B) 


RBA of 


Current 
High Level 
Index Record 


High Key 
of Lower 
Level Record 


BUFC 


lst Time 


Processing, 


Output of 
Step 2; 


Output of 
Step 11. 


7 


Otherwise F_—> 8. 


. Rewrite the previous record. 


VSAM 


——, 
Se 


Horizontal Pointer to New Index Record 


Reread the previous index record at the 
current index level and complete it. 


. When a higher-level index record doesn’t exist, 


create a new high-level index record. 
A Index Buffer 
. Retrieve the current index record for the next See cael New Irepr 
higher index level above the current level. Entry 


. Insert the high-key value of the lower-level index aE cwA__ 


record just completed into the dummy entry of Le 
the higher-level index record. eS 


PAL LP gt So 
i ee 


. When the new entry doesn’t fit in the high-level BUFC 
index record, free the current index buffer. ane 
=, Available 
. Acquire a new index buffer and initialize it for Flag 
continued sequence-set index-entry insertions. eee 
Index Buffer 


. Return to the caller. 
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Notes for Diagram BG5 The processing of steps 3 through 13 1s repeated until 
an index entry is successfully inserted in an index 
8 IDAO19RJ: IDAR record on the index level above the level on which a 
The previous index record at the current index level is new index record is created. 
reread. 14 
IDA019RG When this sequence-set record is completed and this 


routine is reentered, this record will be written at step 
2, overlaying the dummy sequence-set record written 
at step 9. 


A horizontal pointer to the new record on the current 
index level is set in the previous index record. 


IDAO19RG: calls IDAO1I9RN (IDAER) 


The dummy entry in the index record is erased, and 
the last (high-key) entry, or entry preceding the erased 
dummy entry, is converted to a section entry. The 
dummy entry is removed without detracting from the 
completeness of the index because a new dummy entry 
has been created by steps 6 and 8 (for high-level and 
sequence-set records, respectively) and because the 
horizontal pointer in the previous record makes the 
dummy entry accessible. 


9 IDA019RJ: IDAWR 
10 IDAO19RG calls IDAO19RN (IDAAQR) 


The index address range definition block (ARDB) that 
governs the range of keys that includes the new index 
entry’s key is located. An ARDB field contains 
information about the next available freespace control 
interval; it is placed in the ICWA. 


IDA019RG: INTNEWRC 


The buffer is initialized as a high-level index record. A 
pointer to the lower-level index record just completed 
(see note 8) is moved into the new higher-level index 
record as the dummy entry representing the highest 
key of the current level of the index. 


11 IDAO19RJ: IDAR 
12 IDA019RG 


The current key in the ICWA for the current index 
level is moved into the current-key field in the next 
higher level’s ICWA. 


IDA019RG: IDAIST 


The value in the higher-level’s ICWA is then inserted 
in the current higher-level record. 


13 IDA019RZ: IDAFREEB 


When a new entry will not fit in the higher-level 
record, a new higher-level record is built to contain the 
new entry. 
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Diagram BH1. Modifying a Key-Sequenced Data Set 
PUT-Insert Processing (Single or Multiple Record Insertion) 


BBI 
5 


1. Locate the data control interval whose range of 


— ——— > keys includes the new record’s key. 


oa 2. Move the control interval into the current data 
JA buffer. 
je / 3. Isthe record to be inserted a spanned record? 
VSAM User’s Virtual Storage / ye No Yes 
/ 4. If the current data buffer isn’t empty, split 
/ the control interval to obtain an empty 
v buffer. 
ye ye 5. If the control area won’t hold the spanned 


Data Buffer 


record, split the control area. 


6. Search the sequence set to locate the entry 
to be converted to a spanned-record- 
segment entry. 


Repeat steps 7 and 8 for each segment. 


7. Move the segment to a buffer. 


8. Put an entry in the sequence set. 


9. Insert the new record into the control interval. 
(See Diagram BH3 for a description of processing 
when there is insufficient space to contain the 
new record.) 


10. Return to caller. 


BB2 | 
7 


RPARM1 


RBA of Data 
Control Interval 


VSAM User’s Virtual Storage 


Data Buffer 
Data Control Interval 


Data Buffer 


New 2 
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Notes for Diagram BH1 


1 


oo PAA 


IDAO19RA 


An index search must be performed. The index leve! 
where the search begins is based on the following 
considerations: 


¢ For skip-sequentia! processing, the index search 
starts at the sequence set. The search normally 
starts at the index record pointed to by the current 
PLH. If the PLH ts invalid, the search starts at the 
first record in the sequence set. 


« For direct processing, the search starts at the 
highest level of the index. 


IDAO19RA calls IDAO19RB, which calls IDAOISRZ 
(IDAGRB) 


The index record at which the search is to start is 
moved into an index buffer. 


IDAO19RB calls IDAO19RC 


The index record is searched for an entry that is 
greater than or equal to the search key. 


IDA019RB 


When the search is unsuccessful, the next record in 
logical sequence ts searched. If the search is successful 
and a lower index level exists, the search ts performed 
on the index records in the lower level. 


IDAO19RU 


If an upgrade set exists, upgrade the alternate indexes 
in it. (see Diagram BRI.) 


IDAO19RA calls IDA019RZ (IDAGRB) 
IDAO19RM calls IDAO19SRT 

For spanned-record processing. 
IDAO19RT calls IDAO19RE 


IDAOI9RE is called until the current buffer, whose 
address is given in PLHDBUFC, is empty. 


IDAO1I9RT calls IDAO1ISRE 


The control area is split also, when the sequence-set 
record won't hold enough entries for the 
spanned-record insertion. 


IDAO19RT calls IDAOLSRC 
IDAO19RT calls IDAO19RS (IDAMVSEG) 
IDAOTSRT calls IDAO19RS (IDAADSEG) 
IDAO19R4 calls IDAOISRM 
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Diagram BH2. Modifying a Key-Sequenced Data Set 
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Data Buffer 
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Data Buffer 


‘Old 
Record 


New 
Record 


Data Buffer 


Free Space Control Interval 


1. 


2: 
No 


. When the records are different lengths, erase the 


New 
Record 


When the new record is not spanned and is the 
same length as the old record retrieved by the 
prior GET-for-update request, move the new 
record over the old record. 


Is the old record a spanned record? 
Yes 


3. Find the record’s position in the sequence 
set. 


4. If the new record has the same number 
of segments as the old, move the segments 
from the user’s area to buffers. 


5. Does the new record have fewer segments 
than the old? 
No Yes 


6. Move the segments from the user’s 
area to buffer. 


7. Convert unused segments’ control 
intervals to free space. 


8. If free space isn’t available for the additional 
segments, split the control area. 


9. Move segments from the user’s area to 
the old control intervals and to the 
free-space control intervals, 


old record and insert the new record. 
(See Diagram BH3 for a description of processing 
when there is insufficient free space in the control 
interval to insert the new record and when 
additional space must be acquired.) 


. Return to caller. et 
; 


c c 
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Notes for Diagram BH2 


1 
2 


IDAO1I9RL 

IDAOI19RL calls IDAO19RS 

Only if old record is a spanned record. 

IDAOI9RS calls IDAO19RC 

IDA019RS: IDAMVSEG 

A CIDF and RDFs are built for each control interval 


that contains a segment. 


6 
7 


See note for step 4. 
IDA019RS: CLEARSEG 


An unused buffer is got and filled with binary zeros 
and a free-space CIDF. It is written for each freed 
segment. 


IDA019RS: DELSEG 


Entries for unused segments are removed, and 
free-data-control-interval pointers are set up. 


IDAO19RS calls IDAO19RF 
See note for step 4 
IDA019RS: IDAADSEG 


Entries for the additional segments are set up in the 
sequence set. 


10 IDAO19RL 


The old (unspanned) record is erased by overlaying it 
with records to its right. If the record is the last record 
in the control interval, it is cleared with zeros. 
IDAOI9RL then calls IDAO19RM to insert the new 
(unspanned) record. 


IDA019RM 


If an upgrade set exists, the alternate indexes in it are 
upgraded. (See Diagram BR1.) 
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Diagram BH3. Modifying a Key-Sequenced Data Set 


Create Space to Insert a New or Modified Record in a Data Control Interval 


RY 


VSAM User’s Virtual Storage 


BUFCs (Index) 


RBA of 
Current SS 


Read 
Required 


Data Buffer 


Output of 
Steps 3 & 5 


. Insert the new record into the appropriate control 


. Create an index entry for the new control interval 


Flag RBA of 2. 
Current CI (ay? 
“Must 
Write’ 
Flag 
3. 
va 
a“ 
Current 
P “ a“ - 
Pointers to 7 4 
Freespace = 
Cls a 
Current 
Record 
Pointer 
(Insert = — > 5 
Point) | 
| 
| 
Data Buffer (Previously Freespace Cl) 
6 


. Write the updated index record, and when a control 


Sequence Set 


Current/Old Data Record 
Control [Interval 
. Ensure that the current sequence-set and the 
current data control interval reflect any changes VSAM 
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et 
When there isn’t a freespace control interval in the 
current control area, move some control intervals 
to the next freespace control area to create free 
space. (See Diagram BH4 for a description of 
processing related to splitting a control area.) 


VSAM User’s Virtual Storage 
Index Buffer 


Valid Sequence Set Index Record 


Old Control Interval 


New Control Interval (Previously Free Space) 


Data Buffer 


recor YYyya | 


When the current control interval must be split, 
move records from the current control interval into 
the next free-space control interval in the current 
control area and adjust RDFs to reflect the new 
distribution of records. 


interval. 


Index Buffer 


ses og A C2 a 


in the sequence-set index record. (See Diagram 
BH6 for a description of index-entry insertion 
processing. ) 


control interval split has occurred, write the old 
data control interval. cc ® 


. When record insertion performed by step 4 is 


unsuccessful, repeat steps 2 through 6. 


. Return to caller. 


Cc 
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Notes for Diagram BH3 


1 


IDAOI9RE calls IDAO019RZ (IDAGRB) 


When the current sequence-set index record has been 
updated by another request since it was last read, it 
must be reread. 


IDAOI9RE calls IDA019RZ (IDAWRBFR) 


When the current data control interval has been 
updated by another request since it was last written, it 
must be rewritten to preserve those updates from 
possible loss. 


IDAOI9RE calls IDAOISRF 


If the record is to be inserted at the end of a control 
interval or if it is one of a sequence of records to be 
inserted at the beginning of a control interval, the 
control interval is not split and the record is placed in 
the next control interval currently containing 
freespace. 


If the request is a direct request to insert a record at 
the beginning of the control interval or if it is either a 
direct or sequential request to insert a record at some 
point other than the beginning or end of the control 
interval, the control interval must be split. 


If the request is a sequential request, the control 
interval is split at the point where the data record is to 
be inserted. 


If the request is a direct request, the record boundary 
nearest to the midpoint of the control interval is used 
as the split point. 


The RDFs are divided among the control intervals so 
that they remain associated with their respective 
records. 


IDAOI9RE calls IDAO19RZ (IDAGNFL) and IDA019RE 
(BUILDFS) 


A work buffer is obtained, converted to freespace, and 
attached to the data insert work area (DIWA). The 
work buffer is used to perform the record insertion 
processing. 


IDAO19RE 


Records to the right of the split point in the old control 
interval are moved into the new freespace control 
interval. Then the moved records are zeroed-out in the 
old control interval and the freespace pointers in each 
control interval’s CIDF are adjusted. 


4 IDAOI9RE calls IDA019RM 


C 


IDAOI19RE calls IDA019SRH 


The new index entry reflects the high key of the data 
records within the new data control interval. If the 
new index entry fits in the index record, the buffer that 
contains the record is not written to the index until the 
new data control interval is written to the data set. 


IDAO19RE calls IDAO19RZ (IDAWRBFR) 


The new data control interval residing in the work 
buffer associated with the DIWA is written. 


IDAO19RE calls IDAO19RH (IXIDAWR) 


The updated index record residing in the index buffer 
associated with the current placeholder is written. 


IDAO19RE calls IDAO1I9RZ (IDAWRBFR) 


When acontrol interval split occurs (see note 3), the 
old data control interval associated with the current 
placeholder is written. 


If the record insertion is unsuccessful after the control 
interval has been split, a second pass results ina 
successful insertion —IDAO19R4 has verified that the 
record fits in a control interval. 
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Diagram BH4. 
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new sequence-set record. Control 
. Initialize a new buffer for subsequent Intervals 
processi1e Gicespace 
Position to the next freespace control area in the 


current extent. 


. Zero out the unused space in the new control ST 


Modifying a Key-Sequenced Data Set 


DIWA 
et 


No. of Control 
Intervals to 
Move 


RBA of Split 
Point 


oe 


Copy control intervals into the freespace control 


10. Split the index record to reflect the new 
distribution of control intervals among the two 
control areas. (See Diagram BH9 for a description 
of processing related to splitting an index record.) 
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Notes for Diagram BH4 


When the process involves adding a record to the end of a 
key range or to the end of the data set, there is no data 
transfer between control areas. Steps 7 through 11 are the 
only steps performed for add-to-end and end-of-key-range 
processing. 


1 


IDAO19RF 


The number of control intervals to be moved to the 
new control area from the control area being split is 
calculated: 


e If the request is a sequential insert request 
(RPLSEQ=ON), all data control intervals to the 
right of the insert point are moved to the new 
control area. 


¢ If the request is a direct request, one half of the 
data control intervals are moved to the new control 
area. 


IDAO19RF calls IDAOI9RW (IDAABF) 


Buffers are added to the placeholder’s buffer chain 
until there is a buffer in the chain for each control 
interval to be moved or until there are no more data 
buffers in the buffer pool. 


The control area can be split if it is filled with the 
segments of only one (unspanned) record. 


IDAO19RF calls IDAO19SF, which calls IDAO19RI 
(IDANEWRD) 


The header of the index record is initialized. 
User’s key less than key of record in old control area: 


The new sequence-set record is pointed horizontally to 
the sequence-set record of the old control area. The 
sequence-set record preceding the old control area’s 
sequence-set record is located. 


IDAO19SF calls IDA019RZ (IDAGRB) 


This preceding sequence-set record is read and pointed 
horizontally to the new sequence-set record. 


IDAO19SF calls IDAO19RZ (IDAWRBFR) 
The preceding sequence-set record is written. 


User’s key greater than key of record in old control 
area: 


IDAO19SF calls IDAO19RZ (IDAWRGFR) 


The new sequence-record is pointed horizontally to 
the sequence-set record that the sequence-set record of 


Cc 


the old control area pointed to and is written. 
IDAO19SF calls IDA019RZ (IDAGRB) 


The sequenct-set record of the old control area is read 
and pointed horizontally the new sequence-set record. 


IDAO019SF calls IDA019RZ (IDAWRBFR) 


The sequence-set record of the old control area is 
written. 


IDAO019SF calls IDA019RZ (IDAHLINS) 
IDA019SF calls IDA019RZ (IDAGNNFL) 
IDAO1L9SRF 


Before acquiring a freespace control area, the data 
buffer control block (BUFC) chain is examined to 
determine whether any of them have an RBA under 
exclusive control within the range of RBAs for the 
control area being split. If there is an exclusive control 
conflict, an error code is set and a return is made to 
the caller. 


If the boundary of the next freespace control area 
exceeds the boundary of the current extent, that is, the 
high-allocated RBA, VSAM End-of-Volume is called 
via an SVC 55 to attempt to acquire more space (see 
Diagram AE1, VSAM End of Volume: Obtain the 
VSAM Object’s Next Volume). If space is unavailable, 
an error code is set in the RPL and a return is made to 
the caller. 


IDAO19RF calls IDAO19RZ (IDAGRB) 


The first control interval is retrieved as a direct 
request. 


IDAOI9RE calls IDAOL9RZ (IDAGNXT) 


Subsequent control intervals are retreived ona 
sequential basis. 


IDAO19RF calls IDAO019RZ (IDAFREEB) 


As each buffer is filled, its must-write flag is set 
(BUFCMW=ON), and then it is released 
(BUFCAVL=ON). 


IDAO19RF calls IDAO19RZ (IDAWRBFR) 


When all of the control intervals eligible for the move 
have been read into buffers, the buffers are written to 
the data set. 


9 IDAOI9RF calls IDAO1I9RK 
10 IDAOI9RF calls IDAO19RI, which calls IDAO1I9RJ 


For add-to-end processing, only a new sequence-set 
record is created. For other processing, the original 


C 


control area’s sequence-set record is split, thereby 
creating a new sequence-set record with index entries 
for the control intervals that were moved to the new 
control area. 
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Diagram BHS. 


BH4 
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Modifying a Key-Sequenced Data Set 


VSAM 
Data Set 


Update a high-level index record with an index 
entry for the new sequence-set record 
generated by the split. (See Diagram BH8 for a 
description of processing related to updating 
higher levels of the index.) 


When the control-area split point shifts asa 
result of index-record split processing, adjust 
the distribution of control intervals among the 
control areas to coincide with the new split 
point. 


Zero out the control intervals in the original 
control area which were copied to the new 
control area. 


Update pointers and retrieve data for 
subsequent processing. 


Return to caller. 


Data Buffer 


BUFC (Index) 


RBA of Sequence-Set 
Index Record Containing 


NANAANAAANAANNANANAARSANANAN 


x 


an Entry for the Control 
Interval to have a 
Record Inserted. 
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Notes for Diagram BH5 IDAO19RZ: IDAGRB 

11 IDAOI9ORI The sequence-set record for the new control area is 
brought into the index buffer. 

12 
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Any control intervals that were copied into the new 
control area and that are no longer validly associated 
with that control area as a result of distribution 
changes effected by the sequence-set split process are 
zeroed out in the new control area. The following 
procedures effect this change: 


All of the buffers in the placeholder’s buffer chain are 
zeroed out. 


IDAO19RF calls IDAO19RZ (IDAGNNFL) 


A buffer in the placeholder’s buffer chain is assigned 
as a work buffer. 


IDAO19RF calls IDAO1ISRZ (IDAFREEB) 


The work buffer’s must-write flag is set on, and it is 
freed. (Note: It is written when the next request fora 
free buffer examines its must-write status and causes it 
to be written before reassigning it.) 


IDAO19RF calls IDAO19RZ (IDAWRBFR) 


The previous two steps are repeated until all invalid 
control intervals in the new control area have been 
erased. All of the work buffers are then written to the 
data set. 


IDAO19RF calls IDA019RZ (IDAGRB) 


The sequence set of the original control area is then 
read into an index buffer. 


If the control interval containing the insert-point 
address is returned to the old control area by the 
process outlined by the previous four steps, the insert 
point must be recalculated. 


IDAO19RF calls IDAO19RZ (IDAWRBFR) 


The buffers are written to the data set. 


14 IDAO1SRF 


Ensure that the PLH points to the sequence-set record 
containing an index entry for the data control interval 
that contains the new record’s insert point. 


IDA019RZ (IDAFREEB) 


If it does not, the index buffer containing the 
sequence-set record for the old control area is 
released. 


IDAOI9RZ: IDASBF 


The buffers that were added to the placeholder’s 
buffer chain to support the control-area-split process 
(see note 1 in Diagram BH4) are released from the 
chain. 


IDA019RZ: IDAGRB 


The control interval that contains the insert point is 
retrieved from the data set and placed in a data buffer. 
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Diagram BH6. Modifying a Key-Sequenced Data Set 
Build an Index Entry and Insert It in an Index Record 
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Compressed Key 
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record and compute the index-entry pointer values 
for both the new and the old data control intervals. 


3. Locate the insertion point for the new entry for the 
old control interval in the index record, and establish 
a front key-compression value for the new entry’s key 
relative to the lower-keyed entry which it follows. 


4. When the current processing is the result of a control 
cy interval split due to a sequential, or mass, insert 
to the old control interval, do the following: 


@ Decrement the low key of the new control EZZ2AG) 
Zz interval by | and use this as the high key of IXSPL 


a“ the old control interval to be inserted into the 
Os index record. 
Front Key 
Compression 
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aC) Control Interval 
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@ Reestablish (see step 3) the front key-compression ppzyzzyy2e77> 
value of the new entry’s key relative to the lower 


New Control Interval ®. key of the entry which it will follow. 
> 5 


aa se . Rear compress the new entry’s key relative to the 
ved A low key in the new data control interval and 


establish the key length of the fully compressed key. 


Request Type 
Pe ete eT 


Old Control Interval 


Index Record 


Higher-Keyed 
Entry 
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Notes for Diagram BH6 


1 IDAOISRH 
2 IDA019RH 
3 IDAO19RH calls IDAO1I9RC 


The index-record search begins with a search of the 
section entries. 


After a section entry whose key is equal to or greater 
than the key being sought is located, the individual 
entries governed by the section entry are examined 
until a key that is greater than the search key is found. 


During the nonsection entry search process, a count of 
the common leading characters of each entry relative 
to the search key is maintained. When control is 
returned to IDA019RH (index insert), this value is 
sometimes used as the front key-compression value of 
the new entry’s Key, or the search key, relative to the 
previous, or lower-keyed, entry in the index record. 


Basing the high key of the new control interval on the 
low key (minus 1) of the next control interval enables 
the sequential insertion process to continue without 
having to update the index record for each record in 
the group of records that are added to the data control 
interval as a mass insert; otherwise, a relatively small 
group of records could establish multiple new high 
keys for the control interval receiving the records. 


5 IDA019RH: COMPRS 


The leading characters of the two keys are compared 
until the first unlike character is found. The like 
characters are dropped from the new key when it is 
compressed. 


The front and rear compression values are then used 
to determine the length of the compressed key. 
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Diagram BH7. Modifying a Key-Sequenced Data Set 


Build an Index Entry and Insert It in an Index Record (continued) 


Common Processing for High-Level and Sequence-Set Insertions 


VSAM User’s Virtual Storage 
6. When the new entry should be a section entry, 


Index Buffer /A _ section entry relative to previous section entries 
JI and repeat step 5 for sequence-set records. 


nA establish a front key-compression value for the new 


7. Establish a front key-compression value for the next 


IMWA 
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>. Compressed 
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x / “A higher key following the new entry relative to the 
/ / / new entry’s key. 
Entries-_ Previous / / 
a Section Entry | / / , 8. When the new entry does not fit in the index record, 
/ / return to the caller. 
a 
/ > 9. Front compress the key field of the next, higher- 
: ointer to 
keyed, index entry. Shae 


Address of 
New Entry’s 
Key 


User’s Area 


Record : : : 
10. Build the new entry and put a new pointer in the 


next entry. 


11. Return to caller. 
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Notes for Diagram BH7 
6 IDA019RH 


For section-entry key compression, the new section 
key is compared against each succeeding section entry, 
starting with the first, in establishing the front 
compression value. 


7 IDAO1I9RH: HLINSERT 


Before establishing a front-compression value, the 
front key compression, or F value, in the high-keyed 
index entry is compared against the front-key 
compression value combined with the key length of 
the new index entry. If the F value in the high-keyed 
index entry is not greater than the other combined 
values, or if the key length, or L value, of the new 
index entry is 0, compression is not performed. 


8 IDAO01I9RH 


The length of the new entry’s key (L value) plus the 
standard F, L, and pointer field lengths are compared 
to the amount of freespace in the current index record 
combined with the front-compression value 
established by step 7. (If the entry is a section entry, 
the length of the section entry pointer (LL field) is also 
included in these calculations.) If there is insufficient 
space for the new index entry, control is returned to 
IDAOI9RJ (index split), by way of IDAO19RI (index 
update), to split the index record. 


9 IDAO019RH 


The higher-keyed entry is moved to the left, 
overlaying the front characters in its key which are to 
be compressed. 


10 IDAO19RH 


The entries following (to the left of) the insert point 
are moved to the left, overlaying the freespace to the 
left of the high-keyed entry in the record, until 
sufficient space exists at the insert point to contain the 
new index entry. 


The following higher-keyed index entry contains the 
key of the new data or index control interval 
generated by IDAOI9RE (control interval split) or 
IDAOI9RJ (index split). Accordingly, its pointer must 
be replaced with a pointer to the new control interval. 
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Diagram BH8. Modifying a Key-Sequenced Data Set 
Update a High Level of the Index with an Entry for the New Sequence-Set Record. 


VSAM Data Set 
a: 1. When there is only one index level in the data set, 


build a high-level index record as follows: 


—_— — —-e® Obtain the RBA of a freespace index control 
Index interval for the high-level record. 


Space [High tot @® Assign an index buffer to the request and 
build the high-level index record. 


a Write the high-level record. 
® Return to the caller. 
y 


Index-Entry Processing When a High-Level Index 
Record Exists 


ICWA (High Level) 


Address of New 
Record 


& 


ICWA (Sequence Set) / 


ANNAAANAAAANANNAN 


Index Record 
Specifications 


2. Search the next higher level of the index for an Index Space 
index record whose range of keys includes the high 
key in the new index record created by the index 
split process. 

Register 15 3. Insert an entry, which points to the new index C 

[ Return Code f record, in the higher-level index record. 

7 

~~ —>» 4. When the insertion is unsuccessful, locate the split ZZZIZZD 
point and split the higher-level index record to ee ee ee 
create space for the new entry. (See Diagram BH9 
for a description of processing related to splitting 


an index record.) 


New High Level 


5. After the record is split following an unsuccessful 
attempt to insert an entry, insert the new entry in 
the unused space generated by the split process 
(see step 4). 

6. Repeat steps 2 through 4 until the index level 
above the level on which the last split was 
performed contains a new entry for the new 
record created by the split process. 

7. Return to caller. 
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Notes for Diagram BH8 


1 


IDAO19RI calls IDAO1I9RN (IDAAQR) 


The index address range definition block (ARDB) that 
governs the range of keys that includes the new index 
entry’s key is located. The contents of the field in the 
ARDB that contains the address of the next available 
freespace control interval is placed in the ICWA. 


IDA019RJ calls IDAO19RK 


If this is the first time that space governed by the 
ARDB located above has been used and if 
sequence-set-with-data is specified, the new index 
record requires preformatting. Starting at the address 
established above, software end-of-file control 
intervals (zeros) are built until the end of the track on 
which replication is to occur is reached. 


IDAO19RI calls IDAO19RZ (IDAGNFL) 
A buffer is assigned to the request. 


IDAO19RI calls IDAO19RH, which calls IDAO19RZ 
(IDAWRBFR) 


The high level index record is written. 
IDAO19RI calls IDAO19RB 
IDAOI19RI calls IDAO19RH 


If there was insufficient space in the index buffer to 
support the index-split process, an attempt is made to 
provide more space. 


IDAO19RI: FINDSP 


The offset to the section entry containing the split 
point is established by tracing along the chain of 
section entries until a section entry is reached whose 
displacement from the start of the index record is less 
than the displacement of the split point used in the 
prior unsuccessful split operation. 


IDAO19RI: LNEXTE 


Using this information, a new split point is established 
for the next attempt to split the index record. 


IDAO19RI calls IDAO19RJ 


The index record is split to create space for the index 
entry associated with the new index record created by 
the split process. 


IDAO19RI calls IDAO19RH 
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Diagram BH9. Modifying a Key-Sequenced Data Set 
Split an Index Record to Create Space for a New Index Entry 
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7. Convert the high-keyed index block into a new 
index record. 
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8. Write the new index record. 
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Notes for Diagram BH9 


IDAO1I9RN: IDAAQR 


The index address range definition block (ARDB) that 
governs the range of keys that includes the new index 
entry's key is located. The contents of the field in the 
ARDB that contains the address of the next available 
freespace control interval is placed in the ICWA. 


IDAO19RJ calls IDAO19RK 


If this is the first time that space governed by the 
ARDB located above has been used and if 
sequence-set-with-data is specified, the new index 
record requires preformatting. Starting at the address 
established above, software end-of-file control 
intervals (zeros) are built until the end of the track on 
which replication is to occur is reached. 


IDAO19RJ: IDAR (calls IDAOISRZ (IDAGRB)) 


The appropriate index record is in the index buffer 
when IDAOI9RJ is entered. However, the index is 
freed by IDAOI9RJ to provide for the contingency that 
preformatting of succeeding index records will be 
required (see note |). Accordingly, the index record 
must be reread. 


IDA019RJ: DELSECT 


Starting with the rightmost, or low-keyed, section 
entry, each section entry is moved to the left by the 
length necessary to eliminate the section entry’s 
section-chaining pointer (LL field). This operation 
continues until the last section entry is reached. The 
last section entry is identified by a section chaining 
pointer containing zeros. 


IDAO19RJ 


For sequence-set index records, a complete set of 
1-byte or 2-byte pointers is built adjacent to the index 
header. The number of pointers equals the number of 
control intervals per control area. 


IDAO19RJ: MOVEPTR 


For high-level index records, each index pointer in the 
index block is moved into the freespace between the 
index header and the index block, moving from left to 
right. The pointers within the block are not altered by 
this procedure. 


IDA019RJ: DELPTR 


The pointers in the index entries are eliminated by 
moving each index entry to the left so that it overlays 
the pointer field of the next higher-keyed entry. 
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7 IDAO19RJ: BUILDREC 


The following operations are performed to recreate an 
index record from a compressed block established by 
the preceding steps: 


a) The right end of the buffer that contains the 
section of the index record to the right of the split 
point is set to zeros. 


b) The first (rightmost) pointer in the group of 
pointers adjacent to the header is moved to the end 
of the index record adjoining the RDF. This 
becomes a dummy entry with F and L fields set to 
zero. 


c) IDAO19RJ: RJE 


The first (rightmost, or low-keyed)) entry in the 
index block is eliminated. This is done to provide 
additional space for the Insert routine. The key was 
previously saved in the ICWA. 


d) IDAO19RJ calls IDAO19RG (IDAIST) 


The key that was placed in the ICWA is front 
compressed (if necessary) and real values are 
established in the dummy entry’s F and L 
index-entry fields. 


e) If there is insufficient space preceding the dummy 
index entry for the Insert routine to insert the key 
and if there is freespace to the left of the index 
block, the index block is moved to the left to 
overlay any freespace that is available. If there is 
no freespace available, or if after acquiring all 
available space there is still insufficient space to 
contain the key, control is returned to the caller, 
IDAOI9RI, the split point is adjusted to the left, 
and IDAO19RI calls IDA0O19RJ to begin the split 
process again. 


f) If there are two or more keys remaining to be 
moved or if the last entry is not a dummy entry, the 
ICWA is adjusted for use by the Insert routine as 
follows: 


The current key is moved into the previous key 
field. 


The current key length is moved into the previous 
key length field. 


The next key to the left in the index record is 
uncompressed and placed in the current key field. 


The key length is placed in the key-length field. 


Cc 


g) Steps 7d, e, and f are repeated until the test in step 
7f is not satisfied. 


IDAO19RJ calls IDAO19RZ (IDAWRBFR) 


The index buffer containing the new index record is 
written to the data set and then freed after it has been 
written. 
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Diagram BH10. Modifying a Key-Sequenced Data Set 


Split an Index Record to Create Space for a New Index Entry (continued) 
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their pointers. 


@® Delete the entry pointers in both blocks of the 
index record. 


Index Buffer 


12. Move the entries to the right of the split point to the 
left to adjoin the pointers. 


13. Convert the low-keyed index block into a new index 
record. 


14. Rewrite the original index record. 


15. Return to caller. 
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Notes for Diagram BH10 
9 IDAO19RJ: IDAR (calls IDAO19RZ (IDAGRB)) 


The original index record is reread. 
10 IDAO19RJ: DELSECT 

See note 3 of Diagram BH9. 
11 IDAO1I9SRJ: COUNT 


The number of index entries between and including 
the first entry to the left of the split point and the 
leftmost (high-keyed) entry in the index record are 
counted. 


IDAO19RJ: MOVEPTRR 


If enough space exists between the header and the 
leftmost index entry for the entry for the entry pointer 
established by the count above, each index pointer in 
the index block is moved into the freespace, moving 
from left to right. 


IDAO19RJ: MOVEPTRI 


If there is not enough space for the entry pointer, the 
pointers are moved by placing the leftmost pointer in 
the index block into the leftmost location in the 
freespace, and by placing the next pointer to the right 
into the next position to the right in the freespace until 
all of the pointers established by the count are moved. 


High-level index record processing is not concerned 
with pointers that have been moved out of the index 
record by the split process. Sequence-set records must 
maintain pointers for control intervals that are freed 
by a control-area-split operation and retain pointers to 
the data control intervals that remain in the control 
area being split; whereas, high-level index records 
have pointers only to lower-level index records that 
are not moved by these processes. 


The steps performed by MOVEPTRR and 
MOVEPTRL are repeated; however, in this case, the 
process is directed against the pointers that are 
contained in the index entries to the right of the split 
point, instead to the left. 


IDA019RJ: DELPTR 
See note 6. 
12 


Starting with the entry to the right of the split point, 
the index block is moved to the left until it reaches the 
pointers that were established by prior steps. 


C 


13 IDA019RJ: BUILDREC 
See note 7. 
14 IDA019RJ: IDAWR 


The index buffer containing the revised index record is 
written to the data set, overlaying the original index 
record. 
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Diagram BI1. ERASE Processing: Key-Sequenced 


BB1 
VSAM User’s Virtual Storage 


Data Buffer 


VSAM 
Data 1. Ensure that the record to be erased is in the a Control Interval 
Set VSAM buffer associated with the request. 


2. Is the record to be erased a spanned record? 
No Yes 


Data Buffer 


Yj / ja 


| Ls aduiidaal Freespace 
| Created by Shift 


Shifted 


3. Locate the record’s sequence-set entries. 


Data Buffer 
Control Interval 


Record to 


4. Convert the control intervals of the record’s 


segments to free space. > (8) 


5. Erase the designated record by overlaying it with 


Data Buffer be Erased _ a? existina records, Records 
—— 
> 6. Adjust or erase the RDF associated with the 


w —_— oe 


L Freespace 


7. Terminate the request and return to the user’s 
processing program. 


Ga 8. Return to caller. 


VSAM User’s Virtual Storage 
BB2 
7 


Records 


LI{ wonessdg jo poyaw 


Cc 


Notes for Diagram BI1 


IDAO19RL 


An ERASE request must be preceded by a 
GET-for-update request that moves the data control 
interval containing the desired record into a buffer. 


IDAO19RU 


If an upgrade set exists, upgrade the alternate indexes 
in it. (See Diagram BRI.) 


IDAO19RL calls IDAO19RS 

For spanned-record processing. 
IDAOILORS calls IDAOL9ORC 
IDA019RS: CLEARSEG 


An unused buffer is obtained and filled with binary 
zeros and a free-space CIDF. The RBA of each 
segment is calculated from the index and placed in the 
BUFC. The buffer is written for each segment. 


IDA019RS: DELSEG 


Entries for all segments except the first are removed, 

and free-data-control-interval pointers are set up. The 
entry for the first segment is converted to indicate an 

unspanned record. 


IDAO19SRL 
IDAO1I9RL 


When the RDF isa single RDF, it is erased. When the 
RDF is a group RDF (that is, two RDFs are combined 
to refer to two or more data records of equal length), 
the following processing occurs: 


e If the count of the records related to the group 
RDF is greater than two, the count is reduced by 
one. 


¢ If the count of the records is equal to one (which 
should not occur), the two RDFs are eliminated 
and the CIDF is adjusted to reflect the increase in 
freespace in the control interval. 


e If the count of the records is two, one of the two 
RDFs ts eliminated and the CIDF ts adjusted. 
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Diagram BJ1. POINT Processing 
VSAM User’s Virtual Storage 


jaa 
tSearch 
Argument 


Data 


VSAM 
Set 


BB1 
5 
1. Locate the control interval that contains the 
specified key or RBA. 
2. Move the control interval into a buffer. 


3. Establish the position of the desired record. 


4. Return to caller. 


BB2 
7 


Register RWORK2 
RBA of Data 
Control Interval 


VSAM User’s Virtual Storage 


VSAM Buffer 


C C 


interval that it falls within. 
2 IDAOI19RA calls IDA019RZ (IDAGRB) 


Notes for Diagram BJ1 
1 Keyed Processing—Key-Sequenced Data Set: 


611 YONeIedO Jo poyepl 


IDA019RA 


When the request is keyed, an index search must be 
performed. The index level where the search begins is 
determined as follows: 


¢« For skip-sequential processing, the index search 
starts at the sequence set. The search normally 
starts at the index record pointed to by the current 
PLH. If the PLH is invalid, the search starts at the 
first record in the sequence set. 


¢ For direct processing, the search starts at the 
highest level of the index. 


IDAO019RA calls IDA019RB which calls IDA019RZ 
(IDAGRB) 


The index record at which the search is to start 1s 
moved into an index buffer. 


IDAO19RB calls IDAO19RC 


The index record is searched for an entry that is 
greater than or equal to the search key. 


IDA019RB 


When the search is unsuccessful, the next record in 
logical sequence is searched. If the search is successful 
and a lower index level exists, the search is performed 
on the index records in the lower level. 


Keyed Processing—Relative Record Data Set: 
IDA019RR 


The relative record number that 1s specified as a 
search argument is converted into the RBA of the 
control interval that contains the record and the offset 
of the record in the control interval. 


IDA019RR calls IDARRDRL 


The control interval is read, unless its RBA falls 
beyond the end of the data set. If the RBA isn’t within 
the data set, then: 


« With KGE, end-of-data is indicated and 
positioning is established at the end of the data set. 


e Without KGE, no-record-found is indicated. 
Addressed Processing: 
IDAO19RA 


The RBA that is specified as a search argument is 
converted into the RBA of the boundary of the control 


Relative Record Processing: 
IDARRDRL calls IDAO19RZ (IDAGRB) 
The control interval is read by RBA. 
IDA019RA 


The control interval is scanned to determine whether 
the key or RBA provided as a search argument is 
within the retrieved control interval. (Note: The RBA 
must represent a valid record boundary within the 
control interval.) 


When the key search is unsuccessful, a test is made to 
determine whether a control interval split has been 
performed by another request-string operating 
concurrently with the current request. If a split has 
occurred, processing returns to step | to performa 
new index search. 


Relative Record Processing: 
IDARRDRL 


Positioning is established by saving in the PLH 
pointers to the record and the RDF and the RBA of 
the control interval. 
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Diagram BK1. ENDREQ: Terminate A Record-Processing Request 


Noncreate 


VSAM User’s Virtual Storage 


RPL 


aaa 
Error Flag 


1. When processing of the current request is not 
complete, issue a WAIT macro against the ECB. 


3. Perform I/O-error processing if necessary. 


(ay 4. Return to the user’s program or to Close. 


Must-Write- 
Status = ON 


Data Buffer 


Data Buffer 


fe ae 
Must-Write = ON 


2. Write any unwritten data buffers to the data set. 


New or Modified 


Control Intervals 


VSAM 
Data Set 


IZ] woneisdg jo poyew 


Cc 


Notes for Diagram BK1 


IDA019R1: FINDOPLH 


The placeholder (PLH) for the request string 
associated with the ENDREQ request is located by 
searching the placeholder list for a placeholder that 
points to the RPL identified by the ENDREQ. 


IDAO19RP: IDAENDRQ 


Other RPLs (if any) in the request string are prevented 
from being processed by setting a flag in the 
placeholder that indicates that an ENDREQ request is 
being processed. (Note: Once a request-string starts 
processing, it continues until all of the RPLs in the 
string are processed or until an ENDREQ is issued. 
When an ENDREQ Is issued, processing against the 
request-string is terminated when processing of the 
current RPL in the string has completed.) If the 
current request is not complete, the WAIT is issued to 
ensure completion. 


IDA019RP: IDAENDRQ 


Before performing any I/O, the processing is forced 
into synchronous mode to ensure that control is not 
returned to the user until 1/O associated with the 
ENDREQ request is completed. When I/O is 
completed, asynchronous processing is restored if the 
processing was previously asynchronous. 


IDAO19RP: IDAENDRQ (calls IDAO19RZ 
(IDAWRBFR)) 


All unwritten data buffers associated with the current 
placeholder are written. 


IDAO19RP: calls IDAO19R5 


The buffer control block (BUFC) chain for the I/O 
block (IOB) in error is searched for a BUFC with an 
error indicator. 


Error conditions are analyzed and an error message Is 
built. 


IDAO19RP calls IDAO19RS (IDAEXITR) 
For processing if aSYNAD routine exists. 
IDAO19RP: IDAENDRQ (calls IDA019RZ (IDASBF)) 


Excess data buffers are released from the current 
placeholder. 


IDA019RP: IDAENDRQ 


The placeholder is released from the current request 
string. 
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Diagram BK2. ENDREQ: Terminate A Record-Processing Request 


Create 


VSAM User’s Virtual Storage 5 


RPL ECB 


as ae 


Index Buffer(s) 


— — — — > 1. When processing of the request associated with 
the ENDREQ request is not complete, issue a 
WAIT macro against the ECB. 


2. Write the current index record, if necessary, and 
write any unwritten data buffers. 


3. When the nonrecovery option is specified (SPEED= 
ON), convert unused control intervals in the last- 


used control area to freespace. 


4. Return to the user’s problem program or to Close. 


VSAM 


Data Set 
Preformatted 


Unused and 
Preformatted 
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Cc 


Notes for Diagram BK2 
1 IDAO19R1; FINDOPLH 


The placeholder for the request string associated with 
the ENDREQ request is located by searching the 
placeholder list for a placeholder that points to the 
RPL identified by the ENDREQ. 


IDAO19RP: IDAENDRQ 


Other RPLs (if any) in the request string are prevented 
from being processed by setting a flag in the 
placeholder that indicates that an ENDREQ request is 
being processed. (Note: Once processing for a 
request-string starts, it continues until all of the RPLs 
in the string are processed or until an ENDREQ is 
issued. When an ENDREQ is issued, processing 
against the request-string is terminated when 
processing of the current RPL in the string has 
completed.) If the current request is not complete, the 
WAIT is issued to ensure completion. 


2 The processing for step 2 ensures that the index entry 
for the last data control interval in the current data 
buffer for the current control area will fit in the index 
record for the current control area. Otherwise, when 
processing is resumed and when the dummy entry in 
the index record does not have space for the key, the 
data control interval would have to be moved to a new 
control area and have its index entry placed in the 
index record for the new control area. 


IDAO19RP calls IDAO1I9RG 


Before writing the index buffer, the following 
processing is performed: IDA019RG checks the 
leftmost entry, a dummy entry for the current control 
interval, in the index record to determine whether a 
maximum length key will fit in the remaining index 
record freespace. If there is adequate space to insert a 
key, IDA019RG writes out the current index record 
and frees the index-create work area(s) (ICWAs). 


If there is inadequate space to contain a key for the 
control interval in the current data buffer, IDAOI9RP 
calls IDA019SA, which recalls IDA019RG, in order to 
have the entry inserted into the index record. 
IDAO19RG returns a no-fit indicator to IDA019SA, 
which forces an end-of-control-area situation for 
IDA019SA (EOCA) processing. In response to the 
no-fit indicator, IDA019SA (EOCA) writes out any 
full data buffers (less the current data buffer) to the 
data set and acquires a new control area. 


3 IDAO19RP calls IDAO19RZ (IDAWRBFR) 
4 IDAOI9RP calls IDAO1I9RK 
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Diagram BL1. CHECK Processing 


BB2 
Ss 


—> 1. When the request’s ECB is not posted as being 
complete, a WAIT macro is issued against the 
ECB. 


——> 2. Perform error processing if necessary. 


3. Return to the user’s processing program. 
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Notes for Diagram BL1 


1 


IDA019R1: FINDOPLH 


The placeholder for the request-string associated with 
the CHECK request is located by searching the 
placeholder list for a placeholder that points to the 
RPL identified by the ENDREQ. 


IDAOISR1I: RICHECK 


A WAIT macro instruction is issued to ensure that the 
asynchronous request, for which the CHECK was 
issued, has completed. 


IDAOI9RI calls IDAOI9RS 


The buffer control block (BUFC) chain for the I/O 
block (IOB) in error is searched for a BUFC with an 
error indicator. 


Error conditions are analyzed and an error message 1s 
built. 


IDAO19R1 calls IDAO19RS (IDAEXITR 
For processing if aSYNAD routine exists. 
IDAO1ISR1I: RICHECK 


The check process is repeated for each RPL (if any) in 
the RPL-string associated with the RPL that the 
CHECK was originally issued against. 


The placeholder is released if necessary. 


The placeholder remains associated with the current 
request-string unless the processing is direct. For direct 
processing, the next request must be repositioned to an 
address in the data set. For sequential or 
skip-sequential processing, the positioning information 
established by a prior request is used by the succeeding 
request. 
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Diagram BM1. VERIFY Processing 


BB2 
VSAM User’s Virtual Storage VSAM User’s Virtual Storage 


———--—> 1. When the data set is key sequenced and the 
recovery option (SPEED=OFF) is specified, 


/ perform the following: y 
7 2 
7 2 
7 a 
AMDSB y, 2 
aaa Fr 4 CIDF 
cf Data Buffer —. 
Data Set a @ Search the data space associated with each index 
Type and data ARDB for a software end-of-file marker 
aaa in order to establish a valid high-used RBA in 
each ARDB. 
ARDB(s) — Data 
pee ee to a 
High-Used @ Search the index to establish the RBA of the 
~ RBA data control interval containing the highest key 
a || TT Ome value in each data ARDB’s space. 
—< om 
aaa 
High Key 
in Data 
Set 


LS) 


. When the data set is key sequenced and the 
ARDB(s) — Index nonrecovery option (SPEED=QON) is specified, 
£9 perform the processing described for step | except 


— ence / that a high-used RBA cannot be established for 
eee the data ARDB(s). 


AAA ANAAARNARANSASANAAARARRRANY 


CI Contain- 
ing High 
Key 


3. When the data set is entry sequenced, establish a 
high-used RBA for the data ARDB, as described in 
fA) step 1, only if recovery (SPEED=OFF) is specified. 


BB2 
7 
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Notes for Diagram BM1 
1 IDAO19R8 calls IDAO019RO 


Other requests are prevented from adding records into 
the data space controlled by the ARDB that is being 
examined by Verify. 


IDA019RO calls IDAOLSRZ (IDAGRB) and IDA019RZ 
(IDAFREEB) 


Starting with the high-used key in an ARDB, retrieve 
and release successive control intervals until a 
software end-of-file marker, that is, a CIDF set to 
zeros, is found. The RBA of the control interval 
containing the software end-of-file marker is used to 
update the high-used RBA in the ARDB. 


IDAO19RO calls IDAO1I9RB, which calls IDAO1I9RZ 
(IDAGRB) 


An index record is moved into a buffer. (Note: The 
search starts at the highest level of the index.) 


IDAO19RB calls IDAOL9RC 


The index record is searched for a key that is greater 
than or equal to the search key. 


IDAO19RB calls IDAO19RZ (IDAFREEB) 


If the search is not satisfied or if lower-level index 
records exist (that is, the current level is not the 
sequence set), the current buffer is released. 
(IDAO19RB then calls IDA019RZ (IDAGRB) to 
retrieve another index record and the search process 
repeats itself.) 


IDA019RO 


When the search is successful, the pointer in the index 
entry is converted into a valid RBA and moved into 
the ARDB. 


2 See note 1. 


3 See note 1. 
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Diagram BN1. 


VSAM 
Data 
Set 


Processing by Control Interval 
GET or GETIX Processing (Control Interv Retrieval) 


: Data or Index Buffer 
1. Retrieve a control interval. C2 Centrol Interval 


Data or Index Buffer 


oO Yes Control Interval 


4 


3. When an I/O error occurs during a sequential ser Ares 


retrieval operation, perform successive reads until 
- a control interval is successfully retrieved. wl RBA or Control Interval 


2. Is improved control-interval access specified? 
N 


Barsuiae ~ 4. Move the control interval or its address into a 
utput o ——_—< Sis, 
user-specified area. 


VSAM User’s Virtual Storage 


a 
a 2 5. Return to caller. 


BB2 
7 


User Area 


6ZI “UoneisdQ Jo poyeW 
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Notes for Diagram BN1 


1 


Normal Control-Interval Processing (NCI): 
Direct Request Processing: 
IDA019R8 calls IDAO1I9RZ (IDASBF) 


When the prior request was sequential, excess buffers 
in the chain of buffers associated with the current 
placeholder (PLH) are released. 


IDAO019R8 calls IDAO1I9RZ (IDAGRB) 


The control interval at a user-specified address is 
retrieved. 


Sequential Request Processing (GET) Only: 
IDA019R8 calls IDAO19RZ (IDAGRB) 


When this is the first request after Open, the control 
interval at a user-specified address is retrieved. 
Subsequent control] intervals are retrieved sequentially 
by IDAOI9RZ (IDAGNXT). 


Improved Control-Interval Processing (ICI: 


The request is decoded. A placeholder is obtained. If 
the request is for update, exclusive control of the 
control interval is obtained. 


IDA019S1 calls IDAO19S3 


The control interval at a user-specified address is 
retrieved. 


IDAO19R8 calls IDAO19RZ (IDAGNXT) 
IDAO19R8: calls IDAO19RP (IDATJXIT) 


Journaling is performed when a journal exit routine 
exists. 


IDAO19R8 calls IDAO19RZ (IDAFREEB) 


For normal direct requests, the buffer associated with 
the request is released before returning to the caller. 
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Diagram BN2. Processing by Control Interval 
PUT-Create Processing (Add a New Control Interval) 


VSAM User’s Virtual Storage VSAM User’s Virtual Storage 


Status 
Flag _ 
| > 1. When the buffer associated with the prior request 


& BUFC(s) 
tNext x 
BUFC ; : Active- 
2. Suspend add processing of other request strings. eae ere eeeeIPIPIIIIIPFOM Status FI ae 


4 
~ 
a | — 
re 3. When all of the control intervals in the current 
\ control area have been used, the following 
a; processing is performed: aaa 
‘ : ‘ igh-Use 
_ © e Write any unwritten data buffers which are 
it r ing. 
a iataaeines associated with the current request string —) High- 
e When data space allocated to the data set Allocated 
. . POLPAL LOLA LALA LLL SL??? ? LLL 
baa is exhausted, acquire more space. RBA 


e When the recovery option is specified (SPEED= 


OFF), preformat the next control area. 


Inactive- 


4. Allow other request strings to process (see step 2). BaP Status 
Flag 


Data Buffer 
5. Obtain a buffer and move a control interval from 
a user-specified area into the buffer, User-Supplied 
Control Interval 


6. Write the contents of the buffer to the data set. 


7. Return to the caller. 


BB2 Set 
7 Freespace 


C U 
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Notes for Diagram BN2 


1 
2 


IDAO19R8 calls IDAO19RZ (IDAFREEB) 
IDAO19R8 


The DIWA, a serially reuseable resource, is examined 
to determine whether another request string is in 
control. When the DIWA is active, processing of the 
current request is deferred. When the DIWA is 
inactive, it is given an active status, which effectively 
defers processing of other requests that may be 
competing for this resource. 


IDAO019R8 calls IDAO19RZ (IDASBF) 
IDAO19R8 calls IDAO19R5 (IDAEOVIF) 
IDAO019R8 calls IDAOISRK 

IDAO019R8 

See note 2. 

IDAO19R8 calls IDA019RZ (IDAGNNFL) 


An available buffer is assigned to the request and 
written if necessary. 


IDA019R8 


The user-specified control interval is moved into the 
buffer. 


IDA019R8 calls IDAOI9RZ (IDAWRBFR) 
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Diagram BN3. Processing by Control Interval 
PUT or PUTIX-Update Processing (Update a Control Interval) 


S — 
Virtual Storage 


Data or 
Index Buffer 


Control 
Interval 


RPL User Area 1. Move the data or index control interval to a buffer 


from the user-specified area. 
Address of User-Supplied a A P 
User Area Control Interval y e : _ 
y 2. Is improved control-interval access specified? 


7 No Yes 
/ 
/ % = 
a 
/ 3. Write contents of the buffer to the data set andgxx eee reerrr> 
then free the buffer. 


> 4. Return to the caller. 


y 


os 
Status Aas 


Address of 
Control Interval 
to be Updated 


VSAM 
Data 
Set 
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Notes to Diagram BN3 
1 Normal Control-Interval Processing(NCD: 


The request is invalid if any of the following 
conditions exist: 


« The record length is not equal to control interval 
size. 


« A PUT request specifies LOCATE mode. 
« A PUTIX request doesn't specify update. 


¢« Astand-alone PUT-for-update is issued without 
specifying user buffering. (Note:““Stand-alone” 
implies that the PUT-for-update is not preceded by 
a GET-for-update.) 


The address of the control interval to be updated is 
established as follows: 


IDAO19R8 calls IDAO19RW (IDAFRBA) 


For sequential requests, the new address calculation is 
based on information in the placeholder. 


For direct requests, the address is taken from the RPL. 
Improved Control-Interval Processing (ICI): IDA019SI 
The request is decoded. A placeholder ts obtained. 
IDA019S1 calls IDA01953 
The control interval specified by the RPL is written. 

3 IDAOI9R8 calls IDAO19RP (IDATJXIT) 


Before writing the new control interval, journaling ts 
performed if a journal exit routine exists. 


IDAO019R8 calls IDAO1I9RZ (IDAWRBFR) 
The new control interval is written to the data set. 
IDAO19R8 calls IDAO1I9RZ (IDAFREEB) 


The buffer is released. 
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Diagram BO1. Creating or Modifying a Relative Record Data Set 


PUT-Insert Processing 


VSAM-User’s Virtual Storage VSAM-User’s Virtual Storage 
7 


Data Buffer 


Empty Slot 


Data Buffer 


GY 1. Locate the control interval that contains the 774 Circ 
: ent Control Area 
| FY | |rors|awr. indicated relative record number. gu” 
Se _” 2. If processing is sequential, advance the record fA 
Records pointer. 
3. Is the control interval beyond the last 
preformatted control interval? 
No Yes New Control Area 


High Used : 
and High v Wl, 
Allocated 4. What is the type of processing? 


RBAs 


Direct o gp 


Data Buffer skip sequential Sequential 
y yp 


Control Interval 


New Control Area 


5. If there is no more space, allocate 
additional space. (See Diagram AE] 


wh 
6. Preformat the next control area. (10) 
7. If creation is for SPEED, preformat the q ) mf. 
rest of the current control area. P 


8. If there is no more space, allocate 
additional space. (See Diagram AE 1.) WE 
YP 

9. Preformat the next control area, and the ty 
O} next, until the control interval that 


YL 


Control 


High Used 
and High 
Allocated 


VSAM RRDS 


Data Set contains the indicated relative record 
number is found. 
yf La 
10. Indicate the end of the last preformatted 
control area. 
FY fe 
\\ 1. Move the record into its slot in the current data La SECOE 
buffer. 


12. Indicate the slot has a record in it. 


13. If positioning is to be released, write the buffer 
and free it. 


14. Return to the caller. 


L c L 
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Notes for Diagram BO1 


1 Direct or Skip Sequential Processing 
IDA019RQ calls IDAO19RR (IDARRDRL) 


If the data set is not being created, or it is being 
created and the control interval is in an existing 
control area, the control interval is read and the 
record pointer is set in the PLH. 


Sequential Creation 
IDA019RR calls IDA019RZ (IDAFREEB, IDAGNXT) 


If there are no more slots in the current control 
interval and the next control interval has already been 
written, the next control interval is read into a buffer. 


IDA019RQ calls IDAO1L9RZ (IDAGRB) 


If there are no more slots in the current control 
interval and the next control interval has already been 
written, the next control interval is read into an insert 
buffer. 


Sequential Insertion 
IDA019RQ calls IDAO19RR (IDARRDRL) 


If the previous request was a POINT for KGE (key 
greater than or equal), its search argument is used to 
retrieve the control interval as though for a direct 
request. 


IDA019RQ calls IDAO19RZ (IDAFREEB, IDAGNXT) 


Otherwise, if there are no more slots in the current 
control interval, the next control interval is read with 
read-ahead buffering. 


3 Direct or Skip Sequential Creation 
IDA019RQ calls IDAO019RZ (IDAFREEB, IDAGNNFL) 


If the control interval is not in an existing control area, 
a buffer is obtained and formatted with empty slots. 


Sequential Creation 
IDA019RQ calls IDA019RZ (IDAGNNFL) 


If there are no more slots in the current control 
interval and the next control interval is not in an 
existing control area, a buffer is obtained and 
formatted with empty slots. 


5 IDAO019RO calls IDAO019SRM (IDAEOVIF) 


End of Volume does the allocation. 


6 IDAO19RQ calls IDAO1ISRK 


Each control interval is formatted with empty slots. 


C 


7 See note for step 6. If the requested control interval is 


among those formatted, processing continues at step 
10. 


8 See note for step 5. 


See note for step 6. During preformatting of control 
areas, End of Volume might have to be called to 
allocate additional space. (See Diagram AE1.) 


10 IDA019RQ 


The high used RBA is at the beginning of the next 
control area—except for creation with the SPEED 
option, for which it is at the beginning of the next 
control interval. 


11 IDA019RQ 


If the slot into which the record is to be moved isn’t 
empty, a duplicate-record error is indicated. 


12 The codes that indicate whether a slot is empty or 
filled are given under ““VSAM Data Set Format”’ in 
‘‘Data Areas.” 


13 IDAO19RQ calls IDAO19RZ (IDAWRBFR, IDAFREEB) 
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Diagram BO2. Modifying a Relative Record Data Set PUT-Update or Erase Processing 
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3. For deletion, adjust the RDF to indicate the slot 
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and free it. 


5. Return to the caller. 
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Notes for Diagram BO2 


IDAO19RQ 


A PUT-update or ERASE request must be preceded by 
a GET-update request. 


IDAO19RQ 


For PUT-update processing, the length of the updated 
record must be the same as that of the original. 


IDAOI9RQ 


The codes that indicate whether a slot is empty or 
filled are given under ““VSAM Data Set Format” in 
‘Data Areas.” 


IDAO19RQ calls IDAOISRZ (IDAWRBFR, IDAFREEB) 
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Diagram BP1. MRKBFR: Marking a Buffer in the Buffer Pool (With Local Shared Resources) 
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VSAM-User’s Virtual Storage 


Is the request to mark for output or to release it? 
+ 
> 2. If the buffer is being written, wait until 2ze(A) (A) 
writing is finished. 
3. Set the RBA for output. 


4. Set the flag that indicates to write the =— 
buffer. 


count. (B) my 
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Notes for Diagram BP1 


1 
2 


IDAO19RY (MRKBF) 
IDAO19RY calls IDAO19R5 (IDADRQ) 


The request is deferred until the buffer has been 
written. 


IDAO19RY 


The RBA of the control interval to be written is 
assigned to the buffer that contains the control 
interval. 


IDAOI9RY 


The placeholder is marked invalid. 
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Diagram BP2. WRTBFR: Writing a Buffer in the Buffer Pool (With Shared Resources) 


V7 


VSAM-User’s Virtual Storage VSAM-User’s Virtual Storage 
1. If a placeholder holds a position in the buffer, 
@ free the placeholder. 


on 2. Determine the type of request. 


TYPE=DS 


>| 3. Write all buffers marked for output for the 
specified AMB. 


4. Indicate that each buffer is empty. 


TYPE=CHK 


~»| 5. Write all buffers marked for output for the 222. 
specified transaction ID. a 


6. Ignore errors. (9 ) 


TYPE=TRN 


7. Write all buffers marked for output for the 222222 ©) 
specified transaction ID. (9) 


TYPE=ALL 


© ~>{ 8. Write all buffers marked for output. CPSLLL LLL LALLA pg & 
9. Return to the caller. 


(B)}- > 
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Notes for Diagram BP2 


3 IDAOISRY: WRTBF calls IDAOISRY (WRBFR) 


WRBER writes the buffers associated with the BUFCs 
indicated by the request. 


5 Same as note for step 3. 


The user indicates the ID of the transaction in the RPL 
TRANSID operand. 


7 Same as note for step 3. 


Same as note for step 3. 
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Diagram BP3. SCHBFR: Searching the Buffer Pool (With Shared Resources) 


VSAM-User’s Virtual Storage G ‘VSAM-User’s Virtual Storage 


— — —> |. If the placeholder holds a position in the. 
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2. Is the buffer number at which to start the 
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4. Search the buffer pool for the specified RBA. 
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available. 


8. Increment the use count. Register 0 


(3X 6) 9. Indicate which buffer contains the RBA. WLLL 


10. Return to the caller. 
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Notes for Diagram BP3 
7 IDAOI9RY calls IDAO019R5 (IDADRQ) 


The request is deferred until the buffer has been 
processed. 
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Diagram BQ1. Processing a Path 


BB2 A request to gain access to a base cluster by way 
2 of an alternate index. VSAM-User’s Virtual Storage 


1. Is positioning in an alternate-index record 
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ay! record. 
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cluster record. ALAg~ eee (B) 
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4. Select a pointer from the alternate-index record. 


5. Set up the inner RPL to use the pointer to gain 


Inner RPL 
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6. Issue the user’s request. 


7. Move any error code to the user’s RPL.———7>(C) 


8. Return to the caller. 
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Notes for Diagram BQ1 


1 


IDAO19RX 


If the request is a PUT or a POINT, no positioning is 
required. If the request is a GET, positioning could 
already have been established by a previous GET. 


IDAO19RX calls IDAOI9R4 
IDAO1I9RX 


The PLH identifies the alternate-index record 
positioned at; the WAX indicates the pointer within 
the alternate-index record positioned at. The 
alternate-index record contains either prime-key 
pointers (for a key-sequenced base cluster) or RBA 
pointers (for an entry-sequenced base cluster). 


IDAO19RX 
IDAOI9RX 


The inner RPL is built by VSAM Open. It is used to 
read the alternate index and to gain access to the base 
cluster. 
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Diagram BRI. 


VSAM-User’s Virtual Storage 


tPLH 


T Record 


tLLOR 
tRPL 


Upgrading Alternate Indexes 
For GET-Update: 


1. Save the portion of the data record that contains 
all of its key fields. 


ERA (A) For PUT or ERASE: 


2. Is upgrading for PUT-update? 
No Yes 


b>. Has any alternate key field changed? 


ad Yes No 


4. Get exclusive control of the upgrade table. ~ — _ 
Repeat steps 5-12 for each alternate index in 


the upgrade set. 


- 
m 


5. Is there a new alternate key to add to the alter- 
nate index? 
No Yes 


6. Read the alternate-index record that has 
the new key, if there is a record, or build 
a new record. 

7. Add to the alternate-index record a 
pointer to the data record. 


8. Write the alternate-index record. 


9. Is there an old alternate key to delete from 
the alternate index? 
No Yes 


¥ 


10. Read the alternate-index record that 
has the old key. 

11. Remove from the alternate-index 
record the pointer to the data record. 


12. If the alternate-index record contains 
no other pointers, delete the record; 
otherwise write it. 


Upgrade RPL 


13. Release the upgrade table from exclusive control. 


. Return to the caller. 
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Notes for Diagram BR1 


1 


eo eo 1 NH 


IDAO19RU 


The LLOR is just large enough to contain the “‘least 
length of the data record” that contains the record’s 
prime key, if any, and all of its alternate keys. 


IDA019RU 


For ERASE, there can be no new alternate key to add. 
For PUT-insert, there is a new key. For PUT-update, 
there is a new key if the alternate key for the alternate 
index being upgraded has changed. 


IDAO19RU calls IDAO19R4 
IDAO019RU 
IDAO19RU calls IDAO19R4 
IDA019RU 


For PUT-insert, there can be no alternate key to 
delete. For ERASE, there is a key to delete. For 
PUT-update, there is a key to delete if the alternate 
key for the alternate index being upgraded has 
changed. 


10 IDAO019RU calls IDAO19R4 
11 IDAO19RU 
12 IDAO19RU calls IDAO19R4 
13 IDAO19RU 
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Diagram BS1. Buffer Management: Reading a Control Interval into a Buffer 
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to read the control interval. 
[oad _ paz 
_ Is the buffer’s BUFC available? 4 


Index AMB 


tBUFDR 


. Ensure that the requested control interval isn’t 
A involved in a control-area split. 


11. Is the requested control interval in the buffer 
pool? 
No Yes 


-{. 12. Increment the use count. 


and set up to read. 

14. Call the I/O Manager to read the requested 
control interval into the selected buffer, and 
wait for completion of 1/O. 


15. Return to the caller. 
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Notes for Diagram BS1 


Buffer Management is called for the processing of almost 
every Record-Management diagram. See the ‘“Procedure 
Called-By Directory” for a list of the modules that call 
IDAOIIRZ. 


1 IDAOI9RZ (IDAGRB) 


If processing is with shared resources, IDAO19RZ calls 
IDAOI9RY; if not, it calls IDAO19R2. 


2 IDAO1I9R2 


If the requested control interval is in the current data 
buffer, processing continues at step 15. The read flag 
in the BUFC is set if: 


e« The requested control interval is not in the buffer, 
¢« Itisin the buffer, but its contents are invalid, 


¢« It isin the buffer, but its exclusive-control level is 
inappropriate, or 


e Share-option 4 is specified. 


3 If exclusive control is required, the requested control 
interval may not be held in exclusive control or for 
writing by another string. If it is, an exclusive-control 
error is indicated: IDA019R2 returns to the caller. 


4 IDAO19R2 initializes the REA fields and read flags of 
the other BUFCs in the chain if the request is for: 


« Sequential retrieval, 
e Control-area split, or 
e« Spanned-record retrieval. 


6 If the requested control interval is in the buffer pool, 
processing continues at step 15. For selecting a buffer 
for an index-set record, if there are more index buffers 
than strings, the surplus buffers can be used. The first 
surplus buffer can be used only for the highest-level 
index record. Other surplus buffers can be used for 
other index-set records. The buffer selected is, in this 
order of priority: 


(1) An empty buffer, 


(2) A buffer that contains a lower-level index-set 
record, or 


(3) A buffer that contains an index-set record of the 
same level 


7 The BUFC 1s not available if its buffer is being used by 
another string. 


Cr 


8 The sequence-set buffer is the buffer allocated to the 
string by Open. It is used for for all requests fora 
sequence-set record and for requests for an index-set 
record when there are no surplus buffers. 


9 IDAOISRY 


No string can own more than one index, one data, and 
one insert buffer at a time. IDAOI9RY enforces this 
rule by freeing a buffer if the request would otherwise 
violate the rule. 


12 If data is in the process of being read into the buffer, 
IDAOI9RY calls IDAO19RS (IDADRQ) to wait until 
I/O has finished. If the use count is incremented to 
more than one and the request is for exclusvie control, 
a read-exclusive error is indicated. 


13 If a buffer not in use is found, it is written if its 
contents have been modified, and the read flag in its 
BUFC is set on. If no buffer not in use can be.found, a 
logical error is indicated, and processing continues at 
step 15. 


14 IDAO19R2 or IDAOI9RY calls IDAO19R3 
The read is initiated. (See Diagram BT 1.) 
IDA019R2 or IDAOI9RY calls IDA019RZ (IDAWAIT) 
Processing waits for I/O to finish. (See Diagram BS3.) 
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Diagram BS2. Buffer Management: Freeing a Buffer 
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6. Return to the caller. 
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Notes for Diagram BS2 


Many Record-Management routines call Buffer 
Management. See 


the ‘Procedure Called-By Directory” for a list of the 
modules that call IDA019RZ. 


1 Processing without Shared Resources 
IDA019RZ: IDAFREEB calls IDA019R2 


If share-option 4 is specified, the buffer contents are 
forgotten. 


If the data insert buffer or an index buffer is being 
freed, the test-and-set byte is cleared and exclusive 
control is released. 


If the buffer being freed contains a segment of a 
spanned record, IDA019R2 releases exclusive control, 
but ensures that exclusive control is kept for the buffer 
that contains the first segment. 


Processing with Shared Resources 
IDA019RZ: IDAFREEB calls IDAO1I9RY 


If the buffer being freed has been modified, its 
modification mask is set to indicate the transaction ID 
of the modifier (which the user specifies in the RPL 
TRANSID operand). If the buffer doesn’t contain a 
segment of aspanned record held in exclusive control, 
exclusive control is released, the use count in the 
BUFC is decremented, and, if share-option 4 is 
specified, the buffer is marked empty. 


5 IDA01I9R2 


IDAO19R2 initializes the RBA fields and read flags of 
the BUFC of each empty buffer if: 


e The read threshold has been reached (that is, 
enough buffers for read-ahead buffering have been 
freed), 


¢ The request is for sequential retrieval, 
e The request is for a control-area split, or 
« The request is for spanned-record retrieval. 


Read-ahead buffering is begun. (See Diagram BT1.) 
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Diagram BS3. Buffer Management: Waiting for I/O Completion 
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Notes for Diagram BS3 


1 
2 


IDA019RZ: IDAWAIT 


If the RPL specifies synchronous and WAITX, exit to 
the UPAD routine. 


The I/O Manager chains channel program segments 
together with cylinder seeks if necessary. When a 
cylinder seek causes a file-protect check, the 
Abnormal-End Appendage, IDAOI9R6, resets the 
starting address of the IOB to point to the CCW that 
follows the cylinder seek. 


The current request is suspended. The Asynchronous 
Routine eventually resumes the request under an IRB. 
When it passes control to step 7, return (at step 9) is 
actually to the Stage-3 Exit Effector. 


See note for step 4. 
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Diagram BT1. I/O Management 
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Page-Fix Appendage 


6. Fix control blocks if they’re not already fixed 
in real storage. 


7. Return to the I/O Supervisor. 


Start-1/O Appendage 


8. Convert the virtual addresses in CCWs to real 
addresses. 


. Create an indirect data address list from the 
virtual page list. 


. Return to the I/O Supervisor. 


Channel-End Appendage 


11. For an asynchronous request, schedule the 
Asynchronous Routine to run. 


12. Reset the BUFC to show the current status. 


13. Return to the I/O Supervisor. 


Asynchronous Routine 
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Notes for Diagram BT1 


1 


IDAO19R3 


If the RPL specifies synchronous and WAITX, the 
ECB pointer in the IOB is set to point to the user's 
ECB. Otherwise, the ECB pointer is set to the VSAM 
ECB. 


IDAO19R3 


For processing with shared resources, IDA019R3 calls 
IDAO19SB. 


IDA019R3 


The virtual page list contains the virtual address of 
each block of storage from which to read or into which 
to write. 


IDA019R3 


The OS/VS I/O Supervisor is called by way of SVC 
114. 


IDA019R9 


The AMB, BUFC, CPA, IOB, and buffers are fixed in 
real storage for I/O. 


IDA019R9 


Each read, write, and write check CCW points to an 
entry in the indirect data-address list that contains the 
real address of each storage block of a buffer. 


11 IDAO19R6 


For a synchronous request, the IOB is posted when the 
I/O completes. 


14 IDAO19R7 


The return address to Record Management is in the 
PLH. 
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Diagram BU1. ISAM-Interface: Processing a VSAM Data Set 


ISAM-Interface Request Translation for QISAM 


1. When the request is a resume-load request, issue 


User-Issued a VSAM GET-locate macro and then a PUT-move 
QISAM PUT Macro macro. 


Otherwise, issue a VSAM PUT-move macro, only. 


User-Issued 
QISAM GET Macro 2. Issue a VSAM GET macro. 


3. When the record associated with the request is a 
User-Issued deleted record and when deleted records are to be 
QISAM PUTX Macro ignored, issue a VSAM ERASE. 


Otherwise, issue a VSAM PUT macro. 


ISNT SE EL Maco 4. Issue a VSAM POINT macro. 


User-Issued 5. Ignore this macro and return to the user’s ISAM 
QISAM RELSE Macro problem program. 


User-Issued 
QISAM ESETL Macro 6. Issue a VSAM ENDREQ macro. 
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Notes for Diagram BU1 


1 


IDAITPM1: QISAM PUT Processing 


To handle an ISAM PUT-Locate request, VSAM uses 
the ISAM-Interface buffer to contain records to be 
written. For ISAM PUT-move requests, the user 
supplies the buffer. (Note: In both cases, VSAM treats 
the buffer as the user’s work area, and transfers 
records to its own output buffers before writing them.) 


For ISAM resume-load requests, a GET-locate is 
issued to VSAM to search the previously created data 
set for a key greater than or equal to the key of the 
first record to be written by resume-load. If the VSAM 
search is unsuccessful, it is assumed that the previous 
last key and the new key are in correct sequence, and 
load | processing continues. 


A successful search indicates that the new key its less 
than a key already in the data set (a logical error); and 
control is passed to the user’s ISAM SYNAD routine if 
it exists. Otherwise, an ABEND is issued. 


IDAIIPM2: QISAM GET Processing 


If the ISAM GET request is preceded by a SETL 
request (used to determine whether the located record 
was a deleted record), the retrieved record is moved 
from the ISAM-Interface buffer to the user’s buffer 
and a VSAM GET macro is not issued. 


When the ISAM GET request is in locate mode or 
specifies data-only, the ISAM-Interface buffer is used 
for the record; otherwise, the user’s buffer is used. 
(Note: Data-only implies that the key resides at the 
beginning of the data record; the relative key position 
of the record is 0.) A VSAM GET macro is issued. If 
the request specifies move-mode and data-only 
options, the data (minus the key) is moved into the 
user's buffer. When a deleted record is retrieved, and 
such records are to be ignored, successive GET 
macros are issued until a normal record is retrieved. 


IDAIIPM2: QISAM PUTX Processing 


If the record to be written had only the data portion of 
the record retrieved (see note 2), the data is moved 
from the user’s buffer to the ISAM-Interface buffer to 
rejoin its key before it is written; otherwise, the 
complete record already resides in the appropriate 
buffer. 


The record is then examined to determine whether it is 
marked as a deleted record. Deleted records are 
ignored, if requested, by issuing a VSAM ERASE 
macro to eliminate the original record from the data 


C 


set. A VSAM PUT macro is issued for those records 
that are to be written. 


IDAIIPM2: QISAM SETL Processing 


The validity of the request is tested, and if two SETL 
requests have been issued without an intervening 
GET, PUTX, or ESETL macro, an invalid SETL 
macro has been issued or an invalid generic key has 
been used. An invalid request error code is set and 
control is passed to the ISAM-Interface SYNAD 
routine (see note 11). 


If the request is valid, the address of the key to be 
located is placed in the RPL, and a VSAM POINT 
macro ts issued. 


If the data set contains deleted records and if the 
request is directed at a specific record’s key, a VSAM 
GET macro is issued to retrieve the record. If the 
record is a deleted record, a no-record-found indicator 
is set in the DCB and control is passed to the 
ISAM-Interface SYNAD routine (see note 11). 


IDAITPM2: QISAM RELSE Processing 


This request is ignored by the ISAM-Interface routine, 
and control is immediately returned to the user. The 
release function is not required by ISAM-Interface or 
VSAM because each QISAM request handled by 
ISAM-Interface uses only a single data record for 
request processing. 


IDAIIPM2: QISAM ESETL Processing 


A VSAM ENDREQ macro instruction is issued to 
release any VSAM resources. ISAM Interface resets 
the scan-mode indicator in the IICB, which enables 
another SETL request to be issued, and returns control 
to the user. 


IDAIIPM2: QISAM EODAD Processing 


This routine recieves control when VSAM reaches an 
end-of-data condition. The ISAM EODAD routine is 
given control if one has been specified; otherwise, an 
ABEND is issued. 
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Diagram BU2. ISAM-Interface: Processing a VSAM Data Set with an ISAM User’s Program 
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ISAM-Interface Request Translation for BISAM 


7. When the request is a stand-alone-write, issue 
a VSAM GET-for-update macro and then a 
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When the request is to write a deleted record, 
issue a VSAM ERASE macro and then a 
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Otherwise, issue a VSAM PUT macro. 


8. Issue a VSAM GET macro. 


9. Issue a VSAM ENDREQ macro to release the 
VSAM buffer associated with the prior request. 


10. Determine whether an error has been detected. 


When an error condition does not exist, return 
to the ISAM-user’s problem program. ISAM User’s Virtual Storage 
When an error condition does exist, pass control 


to the ISAM-user’s SYNAD routine. DECB (for BISAM) 


CAA, Error Codes 


ISAM-Interface SYNAD Exit Processing 


11. Map VSAM completion codes into ISAM 
control blocks. 


When the current processing is QISAM, pass 
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Notes for Diagram BU2 
7 IDAIIPM3: BISAM WRITE Processing 


The ISAM-Interface RPLs are searched for one which 
is associated with the current request’s DECB. If an 
RPL is not found, an available RPL is assigned to the 
request and initialized. If an RPL is not available, an 
invalid request is indicated in the DECB and a return 
is made to the user’s problem program. 


If the write request is an ISAM stand-alone-write for 
update, VSAM GET-for-update and PUT-for-update 
macros are issued to satisfy the request. 


For a write request to overlay an existing data record 
with a deleted record, the VSAM PUT macro is issued 
to satisfy the request unless the option to ignore the 
deleted record is specified. In this case, the ERASE 
macro is issued. (Note: Deleted records have a X‘FF’ 
in their first byte.) 


For a write-key-new request, a VSAM PUT is issued. 
If VSAM returns an error code indicating that the 
record to be written is a duplicate of an existing data 
record, ISAM-Interface issues a VSAM GET to 
retrieve the existing data record to determine whether 
it is a deleted record. If the record is a deleted record, 
a VSAM PUT-for-update request is issued to replace it 
with the new record. 


When VSAM returns control, the ISAM-Interface 
RPL is released (disconnected from the DECB), a 
VSAM ENDREQ macro is issued to free the VSAM 
resources, and the request is posted complete. 


IDAIIPM3: BISAM READ Processing 


The RPLs are searched for one which is associated 
with the current request’s DECB. If an RPL is not 
found, an available RPL is assigned to the request and 
initialized. If an RPL is not available, a return is made 
to the user’s problem program. 


After establishing the buffer to be used (that is, an 
ISAM buffer or an ISAM-Interface buffer) and 
adjusting the record pointer to include a record 
descriptor word (RDW) for variable-length records, a 
VSAM GET macro its issued. 


When VSAM returns control, the ISAM-Interface 
RPL is released (disconnected from the DECB) and a 
VSAM ENDREQ macro is issued to free the VSAM 
resources, unless the ISAM request was a successful 
read-for-update. 
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IDAIIFBF: BISAM FREEDBUF Processing 


This routine issues a SYNCH SVC to get into problem 
program state and then searches the ISAM-Interface 
request-string for an RPL associated with the current 
ISAM DECB. When found, a VSAM ENDREQ 
macro is issued to free the resources held by the RPL. 
The RPL is then disconnected from the DECB. If an 
associated RPL is not found, a return is made to the 
user’s problem program. 


If the RPL is found and processing of it is complete, a 
VSAM ENDREQ macro is issued to free the VSAM 
resources, and then the ISAM-Interface RPL is 
released (disconnected from the DECB) for reuse by 
another request. 


10 IDAITPM3: BISAM CHECK Processing 


11 


The ISAM-Interface Check routine tests for an error 
code in the DECB (see note 3). If an error is not 
detected, a return is made to the user’s problem 
program. If an error is detected, the Check routine 
passes control to the users ISAM SYNAD routine if it 
exists; otherwise, an ABEND is issued. 


IDAIISM1: ISAM-Interface SYNAD Processing 


The ISAM-Interface SYNAD routine is entered by a 
VSAM processing routine when an error condition is 
detected. 


For QISAM processing, the VSAM error codes in the 
RPL are copied into the DCB, and for BISAM 
processing, the error codes are copied into the DECB. 


For QISAM processing, control is passed to the user’s 
ISAM SYNAD routine if it exists. If it does not exist, 
an ABEND is issued. 


For BISAM processing, a return is made to VSAM, 
which returns to the ISAM-Interface BISAM 
processing routine and then to the user’s problem 
program. An ensuing ISAM CHECK macro causes the 
user's ISAM SYNAD routine to receive control if it 
exists (see note 10). 


The ISAM-Interface SYNAD routine also builds the 
SYNADAF message. 
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Diagram CAl1. GENCB: Build a New Control Block 


User’s Program 
Argument Control Entry Issued GENCB 
Header 
Block Type 
Number of Copies 


Length of User Area 


R1 
Parameter 
List 


Parameter List 


tHeader ACE 
tElement ACE 
tElement ACE 


— 1. Did the user request an ACB, RPL, or EXLST? 


Yes No é 
<> Return to the user on error. 


“a 


“> 2. Determine the amount of virtual storage needed to 
satisfy the user’s request. 


“’ 3. Did the user supply an area to build the control 


block in? 
\ Yes No 
LEY 
Element \ 4. Obtain virtual storage for the control block. 
5. Is the user’s area large enough? see edie 
Yes Control Block and Copies 


N 
{> Return to the caller on error. 


Field’s Data 


7. Locate the ACE’s keyword-entry in KEYWDTAB. 


8. Determine the entry type and process it as follows: 


Bitstring-type entry: 


9. Validate the bits in the string and place them 
in the block. Reset the default bits if necessary. 


Normal-type entry in an EXLST control block: 


10. Move the exit-routine address from the element 
ACE into the EXLST control block. 


11. Set the exit attribute flags. 
Normal-type entry in an ACB or RPL control block: 


12. Move the user-supplied information from the 
element ACE into the control block. 


13. Return to the user’s program. 


C Cc UL 
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Notes for Diagram CAI 
1 §IDAOI9CI 


The GENCB macro instruction is issued to create an 
ACB, RPL, or EXLST dynamically. 


2-5 
The ACB and RPL are fixed-length control blocks, but 
the EXLST is variable length. The Contro! Block 
Manipulation routine calculates the amount of space 
needed for the control block and any copies the user 
requested. The Control Block Manipulation routine 
issues a GETMAIN macro instruction to obtain the 
required virtual storage for any block for which a user 
area is not provided. 


6 The block is initialized to its default values. 
Information is subsequently added to the block as 
specified by the element argument control entries 
(ACEs). 


11 The exit attribute flags indicate that an exit address is 
present, active, inactive, or set during link-edit. 


21307 (WVSA) Pola] Sse99y adesOIg JENA :UaUOdWIOD 1Uopuadapuy SAS ZSA/SO Z91 


Diagram CB1. MODCB, SHOWCB, TESTCB: Modify, Display, or Test a Control Block 


R1 Argument Control Entry 


Request Type 
tControl Block 


User’s Program Issued 
MODCB, SHOWCB, 
TESTCB 


Parameter List 


tHeader ACE 


tElement ACE : 


1. Did the user specify a valid control block type? 


\ Yes No 
Ga Return to the user on error. 


tElement ACE 


av 2. Did the user supply valid keywords with his request? 


Lye Yes No 
4 Gee} Return to the user on error. 


Process each user-supplied element ACE: 


MODCB (Modify control block) request: 


>] 3. Examine each of the user-supplied keyword 
entries to verify that the user is allowed to 
modify the control block fields. 


a) 


Determine the field type and process it as follows: 


Normal-type field in an ACB or RPL: 


4. Replace the control block field with the 
information in the element argument 
control entry. 


Normal-type field in an EXLST control block: 


ACB, EXLST, or RPL 
Control Block 


Field(s) to be 
Modified 


5. Modify the field as specified by the 
element argument control entry. 


6. Modify exit attribute flags. 


Bitstring-type field: 


7. Modify the control block field bit-by-bit as 
specified. 
Reset conflicting bits 1f necessary. 


CB2 
8 


a 
eo 


ACB, EXLST, or RPL 
Control Block 


Modified Field(s) 
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Notes for Diagram CB1 


1 IDAO019C1 


The MODCB, SHOWCEB, and TESTCB macro 
instructions are issued to modify, display, and test, 
respectively, the ACB, RPL, and EXLST control 
blocks in the user’s address space. 


31307] (WYWSA) Poula] ssa00y a3BI0Ig [EN LIA :JUaUOdWIOD JUspusdapu] SAS ZSA/SO P9I 


Diagram CB2. MODCB, SHOWCB, TESTCB: Modify, 
Display, or Test a Control Block 


Argument Control Entry 
Header (for SHOWCB) 


Control Block Type 
tControl Block 


Length of User’s Area 


Element 


Header (for TESTCB) 
Control Block Type 


tUser’s Test-Analysis 
Routine 


ACB, EXLST, or RPL 


Field(s) to be 
Displayed or 
Tested 


SHOWCB (Display control block) request: 


Determine the field type and process it as follows: 
Normal-type field: 


9. Compare the user-supplied data with the 
control block’s field. 


Bitstring-type field: 


10. Compare the control block’s field bit-by-bit 
as specified by information in the ACE. 


> 11. Was an error detected by TESTCB, and did the 
caller provide an error-return address? 


No Yes 


v 


12. Return to the user’s error-return address. 


13. Return to the caller’s program. 


User’s Work Area 


Field(s) 
Requested by 
the User 


Condition Code 
Indicates Test 
Results 


$9] uoneiedyO jo poy 


Notes for Diagram CB2 


4-13 


The field attribute table entry contains the length, 
offset from the beginning of the block, and 
characteristics of the field in the control block. 


Three types of entries are identified in the field 
attribute table: bitstring, normal, and entries that 
require a special subroutine to process them. 


If the entry is a bitstring type, the field attribute table 
points to a series of bit entries in the bitstring table 
that are used to modify the control block (MODCB), 
or are compared to a value supplied by the user 
(TESTCB). 


If the entry is a normal type, the element argument 
control entry is moved into the block (MODCB), a 
character string or field is moved into the user’s area 
(SHOWCB), or the user’s argument field is compared 
with the appropriate fields in the block (TESTCB). 
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Diagram DAI. VSAM Catalog Management Table of Contents 


VSAM Catalog 


Management 
Overview 


Diagram DB1 


GENDSP: Generate SuperLOCATE: LOCATE: Retrieve UPDATE: Modify LSPACE: 
a Data Space List a Data Set’s Catalog Catalog Build an ‘Available 
DSNAME Volumes Information Information Space”’ Report 


Search: Retrieve Check the 


the Base Catalog 
Record 


Diagram DC1 Diagram DD1 Diagram DF1 Diagram DGI1 Diagram DE1 Diagram DH 1 Diagram DK1 


Password 


Obtain a Catalog UPDATE-Extend: Modify a , 
Record Field’s Obtain Additional Catalog Record Retreat 

Sais VSAM Data Set 
Value Space Field’s Value 


Diagram DL1 Diagram DI1 Diagram DM1 Diagram DI3 


LEGEND 


SUBALLOCATE: 
Obtain Space from a 


Flow of control on the same page; 
‘3’ indicates a number of a process 
step on the same page. 


Flow of control between pages; : 

‘AA3’ is the diagram number and 
‘2° is the number of a process step 

on that diagram. 


Nonunique Data Space 


Pointers 


Reference to data or testing of 
data by a process step; ‘H’ is an 
arbitrary designation. 


Input to process steps and output 
from process steps; ‘A’ is an 
arbitrary designation. 


Modification of data by a process 
step; ‘P’ is an arbitrary designation. 
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Diagram DB1. VSAM Catalog Management Overview 


VSAM Open, Close, and End-of- 
Volume, and Access Method 
Services issued CATLG 

(SVC 26) fora VSAM 


Catalog Record. OS/VS 
Catalog Management enters 


VSAM here. 
Ri VSAM Catalog Management R15 
tCTGPL Su: 1. If caller is not in supervisor state or key 0, validity- P2@@gegezp 
~~ = check the CTGPL. If check fails, issue WTO message Z Ril 
CTGPL Gs... 1EC338] and return to caller. Z 

R tT 
. Te 2. Issue GETMAIN for CCA. If GETMAIN fails, issue g 

Catalog Record “ re ~ WTO message IEC339 I and return to caller. @Zzz727z277 CCA CTGPL CTGFLs 

. ~ — ps 
Identifier ~ LN 3. Build and initialize a CCA for the caller’s request. 


tCTGFL —— = 
|fcTGFL = F-) croFts a 4. Initialize the caller’s CTGPL and CTGFLs. zzzzzzd(O) 

Ph a ee —. —_ 
— | 5 \ 5. Retrieve the catalog record identified by the caller: HY” 


‘“ (See Diagram DC1, ‘‘“SEARCH: Retrieve the Base 
Sf O Catalog Record.’’) 
VSAM Catalog 6. If the caller issued an Access Method Services VSAM Catalog Management Buffer 
command, process it and by pass steps 6 through 8 
<i 


(See Diagram EB1, ‘“‘Catalog Management Services 
eran Overview.”’) 
\ #9 7. Check the caller’s authorization to use the record: 


a, 
(See Diagram DD1, “Check the Password.’’) 


VSAM Catalog Record 
(from Step 5) 


” 


Operator-Supplied 


Password a 


Authorized Not Authorized 


Raee>(5) 


DB2 
8 
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Notes for Diagram DB1 


VSAM Catalog Management is called by OS/VS Catalog 
Management when VSAM Open, Close, End-of-volume, 
and the Access Method Services routines issue the 
CATLG macro instruction (SVC 26). Register 1 contains 
the address of the caller’s catalog parameter list. The 
catalog parameter list identifies which catalog record to 
process and what process to perform. 


A user’s program can access the VSAM catalog by issuing 
an Access Method Services utility request. Access Method 
Services translates the request into an SVC 26 and a 
catalog parameter list. 


The LOCATE command is processed first by the VSAM 
catalog management routines and then, if the requested 
information is not in a VSAM catalog, by the OS/VS 
catalog management routines. 


IGC0002F 


Register | contains the address of a catalog parameter 
list (CTGPL). OS/VS Catalog Management transfers 
control (XCTL) to VSAM catalog management 
transient module, IGGOCLAI. 


IGGOCLAI1 loads IGGOCLCS9, if IGGOCLC¢ is not 
already loaded, and calls IGGOCLC9 to process the 
VSAM catalog management request. 


1 IGGOCLC9: BLDCCA 


A call is made to the task supervisor validity-check 
routine to verify that the storage passed as a CTGPL is 
owned by the caller. A condition code of 8 is set in the 
PSW if the check is successful. 


2 IGGOCLC9: BLDCCA 


Issue a page boundary GETMAIN for CCA and 
record areas. If return code is not zero, issue 
“insufficient storage’’ message. Set return code 8 in 
register 15 if caller was a SUPERLOCATE request or 
a translated request. If it was not, set reason and error 
code and module ID in the CTGPL. 


3 IGGOCLC9: BLDCCA 


The catalog control area (CCA) contains data about 
catalog records retrieved to process the request. The 
CCA also contains a register save area that shows the 
flow of control between catalog management routines 
used to process the request. 


Each time a catalog management routine calls another 
catalog management routine, the contents of registers 
12, 13, and 14 are put in the CCA’s register save area. 
Register 13 contains the address of the next 12-byte 


C 


register save area in the CCA. Register 12 contains the 
address of the calling routine. Register 14 contains the 
return address to the calling routine. 


See “‘Data Areas” for details about the CCA and 
CTGPL. 


See *‘Diagnostic Aids” for details about the CCA 
register save area. 


IGGOCLAB: IGGPACDY (calls IGGPSCNC 
(IGGOCLAY)) 


The caller’s work area and each CTGFL are checked 
to ensure that it is within the caller’s address space. 


The CTGFL’s field-name value is used to obtain 
dictionary data that defines the field’s characteristics 
and location within the record. 


See ‘‘Data Areas” for details about the field name 
dictionary. 


IGGOCLAB: IGGPACDV (calls IGGPSCAT 
(IGGOCLAH)) 


The catalog record is identified by the caller’s dsname 
value, volume serial number, or control interval 
number. 


IGGOCLAB: IGGPACDV (calls IGGPCDVR 
(IGGOCLAT)) 


An Access Method Services command is translated 
into a catalog management services request to define, 
modify, delete, or list catalog records. 


IGGOCLAB: IGGPACDV (calls IGGPCKAU 
(IGGOCLBM)) 


The caller’s request type determines the level of 
password that, when supplied by the operator, allows 
the VSAM catalog management routines to complete 
the caller’s request. 
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Diagram DB2. VSAM Catalog Management Overview 


R1 


—--—-—-—-— ET 8. Determine the request type and process it: 


LOCATE M(See Diagram DEI, “LOCATE: Retrieve 
Catalog Information.’’) 


SUPER- > (See Diagram DG1, ‘‘ SUPERLOCATE: 
LOCATE List a Data Set’s Volumes.’’) 


Request Type 


GENDSP m(See Diagram DF 1. ““GENDSP: List the 
Contents of a Data Space.’’) 


UPDATE E> (See Diagram DH1, “UPDATE: Modify 
Catalog Information.’’) 


LSPACE (See Diagram DK1, “LSPACE: Build an 
‘Available Space’ Report.’’) 


9. Release virtual storage obtained for this request. 


OS/VS Catalog Management 


10. Write problem determination message and set error 
code, if any. 


CCAPROB 
Return Code 


Register 15 


—— > 11.Return to the caller. B2224>1 Return Code 
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Notes for Diagram DB2 1GC0002F puts the return code (register 2’s contents) 
into register 15 and returns to the caller via the SVC 
8 IGGOCLAB: IGGPACDV (calls IGGPSLOC return. 


(IGGOCLAM), IGGPGDSP (IGGOCLBJ), IGGPLOC 
(IGGOCLAZ), IGGPUPD (IGGOCLAV), or IGGPLSP 
(IGGOCLBK)) 


IGGPSLOC: 


A SUPERLOCATE request builds a list of all volumes 
and units associated with a dsname. 


IGGPGDSP: 


A GENDSP request builds a list of all VSAM data sets 
in a VSAM data space. 


IGGPLOC: 


A LOCATE request retrieves information from the 
catalog record. 


IGGPUPD: 


An UPDATE request modifies information in a 
catalog record. An UPDATE request can also obtain 
direct-access space for the data set or index identified 
by the dsname value. 


IGGPLSP: 


A LSPACE request determines the amount of 
available space on a VSAM direct-access volume, 
when the volume is described in a VSAM catalog. 


9 IGGOCLC9: IGGPRCLU 


When the VSAM catalog management request is 
complete, all virtual storage obtained for work areas, 
control blocks, and the request’s CCA is returned to 
the OS/VS system. 


10 IGGOCLC9: IGGPRCU 


Write problem determination message, if it was a 
SUPERLOCATE request or a translated request, and 
set error code in CTGPL. 


11 


VSAM catalog management common processing 
(IGGOCLCY9) sets a return code in register 2 and 
returns to IGGOCLAI. 


IGGOCLAI deletes IGGOCLC9 and transfers control 
(via XCTL) to IGCO002F. Register 1 contains the 2s 
complement of register 1’s contents when IGGOCLAI 
was entered, to indicate to IGC0002F whether or not 
the CATLG macro instruction (SVC 26) was issued by 
a VSAM catalog management procedure. 
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Diagram DC1. SEARCH: Retrieve the Base Catalog Record 


Retrieve the Base 
Catalog Record 


Virtual Storage for the Caller’s Program 


Virtual Storage for the Caller’s Program 


1. Did the caller identify a catalog to search? 


ANo Yes 
/ 
7 
a v Search the caller-specified VSAM catalog 
v tes > The catalog identifier addresses a catalog’s: 
-- seat 
2. DSNAME: Examine each PCCB for a Catalog 


Va matching DSNAME, and then 


Catalog Record (D)- cd 
Identifier 


3. ACB: Put the catalog’s ACB address 


. 
into the CCA. 
\. ©] 
VSAM User’s Address Space \ y. © (E) 


TCB (A) Y 7 
Y Search each VSAM catalog available to the caller. 
; 


y ®) 44. Determine which catalog to search, based on the 


JSCB PCCBs ACB y, requirements of the request. 
Catalog’s 5. Search each VSAM user catalog identified by a PCCB: 
ACB J 


/ 6. When all user catalog’s have been searched, search 
the VSAM master catalog. 


. The catalog record identifier addresses either: 


CVT AMCBS ,. 


tVSAM Master 


e A data set’s DSNAME or a volume’s serial 


number 
® or 


e A catalog record’s control-interval number. 


Catalog’s 
ACB 


Catalog’s 
DSNAME 
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Notes for Diagram DC1 
1 IGGOCLAH: IGGPSCAT 


The CTGPL’s catalog identifier field, set by the caller, 
can contain the address of a catalog’s ACB, the 
address of a catalog’s dsname, or 0. 


See “‘Data Areas” for details about the CCA, ACB, 
and CTGPL. 


IGGOCLAH: IGGPSCA 


The catalog specified by the caller is the only catalog 
searched. The Catalog Management Services DEFINE 
routine calls the Search routine to confirm that, when 
a caller wants to create a VSAM cluster or catalog, the 
new cluster or catalog dsname isn't duplicated in the 
catalog. The caller (Catalog Management Services 
DEFINE routine) expects the “no record found” 
return code. 


If the CTGPL’s catalog identifier field contains the 
address of a catalog dsname, the search routine 
examines each protected catalog control block (PCCB) 
for a matching dsname field. Each PCCB contains the 
address of its catalog’s ACB. 


If no PCCB contains a matching dsname, the 
user-supplied catalog dsname refers to either a 
nonexistent catalog or to an unopened catalog. 


See ‘‘Data Areas” for details about the CCA and 
PCCB. 


See ‘Diagnostic Aids” for details about catalog 
management error codes. 


IGGOCLAH: IGGPSCA 
IGGOCLAH: IGGPSCA 


Some user requests, such as DEFINE CATALOG and 
DELETE CATALOG, require searching the VSAM 
master catalog and prohibit searching user catalogs, 
even if they are specified. 


If the CTGPL’s catalog identifier field contains 0, the 
VSAM user catalogs specified by the user’s JCL 
JOBCAT and STEPCAT DD statements, and the 
VSAM master catalog, are searched until either the 
record is found or there are no more catalogs to 
search. 


See ‘Data Areas” for details about the CTGPL search 
options, cluster catalog records, and volume catalog 
records. 


The JSCB contains the address of the first PCCB in 
the PCCB chain. Each PCCB describes one of the 
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VSAM user catalogs that have been opened to satisfy 
the user’s JCL JOBCAT and STEPCAT DD 
statements. A PCCB contains the address of a 
catalog’s ACB. The catalog’s ACB address is put in 
the CCA to identify the catalog being searched. 


See “‘Data Areas” for details about the PCCB, ACB, 
and CCA. 


IGGOCLAH: IGGPSCA 


The AMCBS (addressed by the CVT) contains the 
address of the VSAM master catalog’s ACB. 


See ‘‘Data Areas’ for details about the AMCBS and 
ACB. 


See OS/VSI System Data Areas for details about the 
CVT. 


IGGOCLAH: IGGPSCAT 


If the CTGPL’s catalog record identifier addresses the 
record’s control interval number, the catalog record 
can be retrieved without a search of the catalog’s 
index. 
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Diagram DC2. SEARCH: Retrieve the Base Catalog Record 


Virtual Storage for the Caller’s Program ; Search the Appropriate VSAM Catalog 


R11 8. Allocate and initialize an RPL for the catalog 


2 <P being searched. ——5B) 


Pal 
—_ 


9. Put the catalog’s ACB address into the RPL. mat (6) 
10. Search the catalog’s index and true-name records 


(See Diagram BC], ““GET-Direct Processing: Direct 
Retrieval.’’) 


tRPLs tBuffer -—-— oe + ——b11. Was the catalog record’s control interval number 
ie found? 
bhi / Yes No 
RPLs y, 


12. Search the next catalog available to the caller. 


YY 


. Read the catalog record from the VSAM catalog 
into a catalog management buffer. (See Diagram 
BC1, ““GET-Direct Processing: Direct Retrieval.’’) 


RPL 
Request 
Options 
TACB 


(From Steps 
8 and 9) 


Index Record 


DSNAME 


Catalog 
Index 
Records 


Catalog 
True-Name 
Records 


High Key-Range CCAPROB 


True-Name Record 
DSNAME| CI# ‘9 


Low Key-Range 


Catalog 
Data 
Records 


Object’s 
Base Record 


Extension Records 


to find the catalog record’s control interval number. 


14. Return to the caller. BazweZzZZZZ Return Code 


Virtual Storage for the Caller’s Program 


Request 
Options 


tACB 


t Buffer 


t Buffer 


Catalog Management Buffers 


True-Name Catalog Record 


Object’s Base Catalog Record 


] 
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Notes for Diagram DC2 
8 IGGOCLAH: IGGPRPLM 


The search routine assigns one request parameter list 
(RPL) to the caller. Catalog management routines 
issue GET and PUT macro instructions to retrieve and 
write catalog records. Each record-management 
request (GET, PUT, etc.) needed to satisfy the caller’s 
catalog-management request refers to this RPL. This 
RPL is initialized for a caller and used as often as 
necessary to process the caller’s catalog-management 
request. When the caller’s catalog-management 
request is completed, the RPL is assigned to another 
caller. 


9 IGGOCLAH: IGGPRPLM 
10 IGGOCLAH: IGGPSCAT (calls IGGPGET (IGGOCLBI)) 


The goal of the search is to find the true name record 
identified by the dsname or the volume serial number. 
The true name record contains the cluster’s dsname or 
volume serial number and the control interval number 
of the cluster or volume catalog record. 


See “Data Areas” for details about the catalog record. 
12 IGGOCLAH: IGGPSCA 


If the caller supplied a catalog’s ACB address or 
dsname, no further catalog searches are performed. 
The search routine sets the ‘‘no record found” error 
code in CCACD1 and returns to the caller. If the 
VSAM master catalog and all VSAM user catalogs 
available to the user’s program have been 
unsuccessfully searched, the search routine returns to 
the caller with the same error code. 


See “Diagnostic Aids” for details about catalog 
management error codes. 


13 IGGOCLAH: IGGPSCAT (calls IGGPGET (IGGOCLBI)) 


The catalog record is located by its control interval 
number and read into a catalog management buffer. 
The buffer’s address is put into the CCA. 


See ‘Data Areas” for details about the CCA. 
14 IGGOCLAH: IGGPSCAT 


See ‘‘Diagnostic Aids” for details about catalog 
management return codes and error codes. 
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Diagram DD1. Check the Password 


Virtual Storage for the Caller’s Program Ny Verify the caller’s authority to bypass password checking 


1. Does the caller want to bypass password checking? 
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Password 
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. Obtain the password from the catalog record. 
(See Diagram DL1, “Obtain a Catalog Record Field’s 
Value.”’) 


Code Word 


Number of 
Attempts 


. Is there a user-supplied password? 


No 


6. Request the password. 


Operator 
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\ 
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> 7. Does the password in the catalog record equal the 
user-supplied password? 


| 
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| ¥ 
\———+—{§- 8. Did the user exhaust the number of attempts 
he has to supply the password? 
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VNY 


Error Return 


c U 


Console or 
TSO Terminal 
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to Operator 


“Supply Correct [Type] 
Password for {[Codeword | 
Data Set” 
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Notes on Diagram DD1 


IDA0192C and IGGOCLAB: IGGPACDV (calls 
IGGPCKAU (IGGOCLBM)) 


When the VSAM Open routine (IDA0192C) calls 
VSAM Catalog Management to retrieve a cluster 
catalog record, the password checking routine 
confirms the user’s authorization to gain access to the 
cluster. 


IGGOCLAT: IGGPCDVR (calls IGGPCKAU 
(IGGOCLBM)) 


When an Access Method Services routine calls a 
catalog management services routine, the password 
checking routine confirms the user’s authorization to 
gain access to the VSAM catalog or a specific catalog 
record. 


The catalog record containing the password(s) is 
available in the buffer addressed by the caller’s CCA. 


See ‘Data Areas” for password set of fields details. 


The type of processing that the user is allowed to do 
with the data set is determined by the password: 


¢ Master password: The user is allowed to modify 
passwords and catalog records that describe his 
data set, and to process his data set’s control 
intervals and records. 


¢ Control-interval password: The user is allowed to 
process the data set’s control intervals as well as its 
records. 


¢ Update password: The user is allowed to process 
his data set’s records. 


¢« Read-only password: The user is allowed to read, 
but not to write (add or update), records in his data 
set. 


IGGOCLBM: IGGPCKAU 


If the user’s password has been verified during a 
previous catalog management request, the caller 
(VSAM Open, or a Catalog Management Services 
routine) can set the CTGPL’s 
bypass-password-checking flag on. 


IGGOCLBM: IGGPCKAU 


Other VSAM catalog management callers, such as the 
user's program (with Access Method Services 
commands), and utility programs, are not in 
protection key O or supervisor state. If these programs 
attempt to bypass password checking, the password 
checking routine sets an error return code that 


C 


prevents further VSAM catalog management 
processing for the caller’s program. 


IGGOCLB6: IGGPSPSC 


The caller can indicate what type of password is 
supplied with the CTGPL, but the password checking 
routine determines the type of password required for 
the request. 


IGGOCLBM: IGGPCKEX 


The password is in the password set-of-fields in the 
cluster, data set, or index catalog record. The CTGPL 
can contain a password that the user supplied in a JCL 
statement. 


IGGOCLBM: IGGPPWGT 


The console operator, or TSO user, can reply to the 
VSAM request-for-password message with a password. 


IGGOCLBM: IGGPPWVR 
IGGOCLBM: IGGPPWVR 
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Diagram DD2. Check the Password 


Virtual Storage for the Caller’s Program 


CTGPL 
CCA 
Password 
Options 
tCatalog 
Record 


Catalog Management Buffer 


Catalog Record 
(Retrieved by the Caller) 


Password 
Set of Fields 


R15 (Set by USVR) _ ~ 


YY 


Call the user security verification routine (USVR) 


9. Did step 7 confirm the data set’s master password? 
Yes No 


10. Is there a USVR specified for the user? 


Virtual Storage 
No 4 for the User’s Address Space 
User Security 


11. Call the USVR to confirm the user Verification 
program’s authorization to process 
the data set’s records. 


Routine (USVR) 


. Is the USVR return code 0? 


7 Yes No 


L. Error Return — 


Return to the caller 


13. Set a return code — successful completion — and 
return to the caller. 


CCAPROB 


error — and return to the caller. 
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Notes for Diagram DD2 


9 


IGGOCLB6: IGGPINMD 


If the user supplied the correct master password, the 
user security verification routine (USVR), if it exists, is 
bypassed. If a USVR exists, the USVR exit is taken 
only if the user provided another type of password 
correctly. 


10 IGGOCLB6: IGGPINMD 


If a user security verification routine exists, its address 
is in the catalog record’s password set-of-fields. 


See ‘Data Areas” for details about the cluster catalog 
record and the password set-of-fields. 


11 IGGOCLB6: IGGPINMD 


The user security verification routine (USVR) is an 
installation-supplied routine that confirms a user’s 
authorization to gain access to the data set. The USVR 
confirms that the user satisfies the installation’s 
security verification criteria. 
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Diagram DE1. LOCATE: Retrieve Catalog Information 


Virtual Storage for the Caller’s Program Virtual Storage for the Caller’s Program 
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Each Set of 
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CTGFL 


CTGIL for Tests 
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CTGFL 2. Do steps 3 through 16 for each of the caller’s 


CTGFLs. 
> 3. Is the field to be retrieved an upgrade field name? 


tCTGFL for Tests 
- aon the associations in the current entry to 


read the upgrade entry into the catalog (B) 
management buffer. 


tCTGFL 


Field Name WS Is the field to be retrieved only if caller-specified the Tests 
Test-Data Area oe coronene are Satisfied? 
Address and Length es 
of Test Data Test Data ie a 
Fa Identify each set of fields that satisfies the 
SL 
‘ On Does at least one set of fields satisfy the test TT 
Catalog Management Buffer conditions. B) Catalog Management Buffer 
Object’s Catalog Record Yes No {psec —_ 


Set of Fields 


Field to Field to \ 
be be (| 
Retrieved | Tested 


Set-of- 
Fields 
Pointer 
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Notes for Diagram DE1 


IDA0192C 


The VSAM Open routine issues the CATLG macro 
instruction (SVC 26) to obtain data set and volume 

information about the user’s data set and index. See 
Diagram AC1, VSAM Open Processing, for details. 


IDA0557A 


The VSAM end-of-volume routine issues the CATLG 
macro instruction (SVC 26) to obtain volume 
information about the extents added to the user’s data 
set. See Diagram AE!, VSAM End-of-Volume 
Processing, for details. 


IGGOCLAB: IGGPACDYV (calls IGGPLOC 
(IGGOCLAZ)) 


When the caller issues a CATLG macro instruction, 
register 1 points to the caller’s catalog parameter list 
(CTGPL). The CTGPL’s request options are decoded 
and the base catalog record is retrieved for the 
request. See Diagram DBI, VSAM Catalog 
Management Overview, for details about initial 
catalog management processing and request decoding. 


IGGOCLB7: IGGPRUS, IGGPFRWK (calls IGGPLOC 
(IGGOCLAZ)) 


Upon completion of Reuse processing, LOCATE is 
called to return catalog field information from the 
reset entry. 


IGGOCLAZ: IGGPEXT (calls IGGPSCNC (IGGOCLAY)) 


Each CTGFL is initialized with the dictionary entry 
associated with the CTGFL’s field-name value. Calls 
from within catalog management (as opposed to 
external calls, such as LOCATE) enter at this point to 
use the field management retrieval function. 


IGGOCLAZ: IGGPSCNF 


Steps 5 through 15 are performed for each of the 
caller’s CTGFLs. 


The Locate routine processes each CTGFL associated 
with the caller’s CTGPL and returns as much 
caller-requested data (in the caller’s work area) as the 
caller’s test conditions and work area size permit. 


IGGOCLAZ: IGGPSCNF (calls IGGPUPGD) 


A caller may request catalog information from an 
associated upgrade entry by using upgrade field 
names. 
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IGGOCLAZ: IGGPUGD 


The upgrade entry may not be in the catalog 
management buffer. If it is not in the buffer, the 
associations in the current entry are used to retrieve 
the upgrade entry. 


IGGOCLAZ: IGGPSCNF 


The caller’s CTGFL list contains the address of each 
CTGEFL required to satisfy the caller’s need for catalog 
information. Each CTGFL describes one of the 
catalog record fields to be retrieved. Each CTGFL is 
completely processed before the next one is started. 


IGGOCLAZ: IGGPSCNF (calls IGGPTSTS 
(IGGOCLBA)) 


A caller might make conditional requests for retrieval 
of catalog record fields. In this case, two CTGFLs are 
supplied with the request and processed together. One 
CTGFL identifies a field to be retrieved and points to 
a second CTGFL that contains the name of the 
catalog field to be tested, the test conditions (equal, 
low, high, etc.), and the address and length of the 
caller’s test data area. The catalog record field 
identified by the second CTGFL is compared to 
(tested against) the caller’s data. If the comparison 
satisfies the test conditions, the catalog record field 
specified by the first CTGFL is retrieved. 


IGGOCLBA: IGGPTSTS 


If the caller wants to retrieve a catalog record’s header 
field, the field’s data is retrieved if all tests are 
satisfied. 


If the caller wants to retrieve a field from one of the 
sets of fields that follow the header fields, the field’s 
data is retrieved from each set of fields that satisfies all 
tests. 


See ‘Data Areas” for details about a catalog record 
and its sets of fields. 


The sequence number of each set of fields that satisfies 
the tests is put in the CCA. After the sets of fields have 
been tested, the sequence numbers in the CCA are 
used to identify each set of fields that contain 
caller-requested data. 
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Diagram DE2. LOCATE: Retrieve Catalog Information 
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Work Area 


area length? 
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Tield Name 
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Current Total 
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Catalog Management Buffer 14. Move the field’s data into the work area. 


Object’s Catalog Record 15. Put the data’s length and address Catalog 
Set of Fields into the CTGFL. Pield’s 
ata 


Set-of- 
Fields 
Pointer 


Field to 
be 
Retrieved 


Other 
Fields 


if) . If the upgrade entry was read in to process an Catalog Management Buffer 
upgrade field name, restore the original entry. 


Object’s Catalog Record 
Vield to 


. Perform final derived-volume entry field processing. 


be 
Retrieved 


. Return to the caller when all CTGFLs have been 
processed. 


Z CCAPROB 
decid Retin Code 
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Notes for Diagram DE2 
8 IGGOCLAZ: IGGPLOC2 


A combination name refers to a set of related catalog 
field names, and is used by the caller instead of a 
separate CTGFL for each field name. 


9 IGGOCLAZ: IGGPLOC2 


The CTGPL, CTGEL, and catalog control area (CCA) 
are described in “‘Data Areas.” 


The combination name index has an entry for each 
field name in the combination. The Locate routine 
processes each field name entry in the combination 
name index sequentially, starting at the index of the 
first field name entry for the combination, and ending 
when the number of entries processed equals the 
number of field names associated with the 
combination name. 


The test sequence (if any) associated with a 
combination-name CTGEFL is done only once, not 
once for each field name in the combination. 


10 IGGOCLAZ: IGGPLOC2 


The address of the catalog’s ACB is in the CCA. All 
other catalog record fields that the caller can request 
are in the catalog record. Each catalog record field is 
identified by its field name. See ““Data Areas” for 
catalog record field names. 


11 IGGOCLAZ: IGGPLOC2 (calls IGGPGVAL 
(IGGOCLBA)) 


Diagram DL1, Obtain A Catalog Record Field’s 
Value, shows how the requested catalog record field 
(specified by its field name in the CTGFL) is located 
for the Locate routine. 


12 IGGOCLAZ: IGGPSHIN 


The first two fields in the caller’s work area specify the 
number of bytes the caller allocated to the work area 
and the number of bytes that contain catalog record 
field data (the ‘‘current total length” exceeds the work 
area length, the current total length field is updated 
with the length of the catalog record data, but the data 
itself is not moved in the caller’s work area. 


14 IGGOCLAZ: IGGPSHIN 


The Locate routine puts the beginning address and the 
length of the catalog field into the CTGFL’s field-data 
entry. 
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15 IGGOCLAZ: IGGPSHIN 


The CTGFL’s field-data entry contains the beginning 
address and length of the data in the caller’s work 
area. When control is returned to the caller, the caller 
can use the field-data entry to locate a specific field’s 
data in the work area. 


16 IGGOCLAZ: IGGPSCNF 


If the field name processed required the upgrade entry 
to be read in, the original entry is restored before the 
next CTGFL is processed. 


17 IGGOCLAZ: IGGPEXT 


If this function was requested by an internal catalog 
management function, final derived-volume 
processing must be done. This processing consists of 
generating certain volume entry fields from the 
catalog information returned in the user’s work area. 


18 IGGOCLAZ: IGGPLOC 


See ‘‘Diagnostic Aids” for details about catalog 
management return codes and error codes. 
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Diagram DF 1. GENDSP: List the Contents of a Data Space 


Virtual Storage for the Caller’s Program 


R3 
tF1DSCB 
in Work Area 


F1iDSCB 


CCA 
Data Space 
t Buffer Timestamp 


Catalog Management Buffer 


R11 


tCCA 


List all VSAM objects in a data space. 
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aR ee uv 
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Notes for Diagram DF1 


The caller (an OS/VS Utilities program or OS/VS Open) 
specifies the GENDSP option of LOCATE to obtain the 
control interval number of the catalog record of each 
object (cluster, data set, index, and catalog) that is 
contained in a VSAM data space identified by a 
DSNAME value (from the format 1 (identifier) DSCB). 


1 


IGGOCLBJ: IGGPGDSP 


The user-provided workarea is tested to ensure that 
the minimum size has been provided. The GENDSP 
routine tests the first seven characters of the data 
space name to determine whether the data space is 
unique. A data space name beginning with 
**Z999999...”” is a nonunique data space. 


IGGOCLBJ: IGGPGUDS 


The true-name catalog record associates the data 
space name with the control interval number of the 
catalog record that describes the data space. 


IGGOCLBJ: IGGPGUDS 


The fixed length of the control interval number area 
and the control interval number are put into the 
user-provided workarea. 


IGGOCLBJ: IGGPGDSP 


The CCA, a CPL, and two FPLs are set up to extract 
the data space group set of. fields for the appropriate 
data space. The DSCB timestamp value is calculated 
from the data space name and used as the test value. 


IGGOCLBJ: IGGPGDSP 


Three FPLs are set up and the Data Set Directory 
entry is extracted. 


IGGOCLBJ: IGGPGDSP 


Scan the Data Set Directory set of fields to find a data 
space sequence number match. 


IGGOCLBJ: IGGPGDSP 


When a sequence number match ts found, the volume 
ACB address, the length of the control interval 
number area, and the control interval number put into 
the caller’s workarea. 


See ‘Diagnostic Aids” for details about catalog 


management return codes and error codes. 
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Diagram DG1. SUPERLOCATE: List a Data Set’s Volumes 
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Notes for Diagram DG1 


The caller (the OS/VS Scheduler) specifies the 
SUPERLOCATE option of LOCATE to obtain a list of 
volume serial numbers (and device types) fora VSAM 
data set’s volumes. The caller identifies the data set with 
its dsname value. 


1 


“a A WM Ge 


IGGOCLAM: IGGPSLOC 


If the VSAM object is a cluster, the cluster’s data 
volumes are described in the cluster’s data set catalog 
record.If the cluster is key-sequenced, the cluster’s 
index volumes are described in the cluster’s index 
catalog record. 


See ‘‘Data Areas” for details about cluster, data set, 
and index catalog records and their sets of fields. 


IGGOCLAM: IGGPSLIN and IGGPDBVC 
IGGOCLAM: IGGPSLIN 

IGGOCLAM: IGGPSLIN and IGGPSLEI 
IGGOCLAA: IGGPSLEN and IGGPSLIV 
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Diagram DG2. SUPERLOCATE: List a Data Set’s Volumes 
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Notes for Diagram DG2 


9 IGGOCLAA: IGGPSLEN 
10 IGGOCLAA: IGGPSLCG 


If the VSAM object is a base cluster data record, call 
IGGPSLY (IGGOCLAA) to obtain upgrade 
associations, if any. 


11 IGGOCLAM: IGGPSLEL 
12 IGGOCLAA: IGGPSLIV 


The volume list pointed to by CTGWAVL has the 
following format: 


The volume list contains no duplicate volume serial 
numbers. 


The volumes are divided by whether they are 
within the minimum unit count or outside it. 
Minimum unit count is the minimum number of 
direct-access devices required to mount the object’s 
volumes. Volumes must be contiguous by device 
type. Device types within the minimum unit count 
are not ordered in any particular sequence nor are 
they related to the device types outside the count. 


Volumes within the minimum unit count will each 
be assigned an individual unit by the Scheduler. If 
volumes that do not have units already assigned 
exist outside the minimum unit count, the last unit 
assigned to a volume of the same device type 
within the minimum unit count will be made 
nonshareable. If this is not possible, an additional 
nonshareable unit will be assigned. 


The volume list pointed to by CTGWAVL has the 
following content: 


All volumes in a given entry are placed into the 
volume list, regardless of whether they have 
allocated space. 


The volume information returned varies according 
to the entry type specified by the Superlocate 
request and whether the volume is within the 
minimum unit count or outside it, as follows: 


Entry types C, D, G, I, and R 

Within the minimum unit count, the CRA volume 
for the particular entry ts returned. 

Data entry (D): 


Within the minimum unit count, every volume in 
the upgrade set is returned. Each volume in the 
data entry that has aunique device type within the 
data entry and is either the first with allocated 


Cr 


space (prime or overflow) or, if no volumes have 
allocated space, is the first candidate volume is 
returned. 


Outside the minimum unit count, all others in the 
data entry are returned. 


Index entry(I): 


Within the minimum unit count, each volume in 
the index entry that has a unique device type within 
the index entry and also is either the first with 
allocated space (prime or overflow) or, if there are 
no volumes with allocated space, is the first 
candidate volume is returned. If sequence set is 
with data, the same volume may appear as botha 
prime and a candidate volume. 


Outside the minimum unit count, all others in the 
index entry are returned. 


NonVSAM entry(A): 


Within the minimum unit count, each volume in 
the nonVSAM entry that has a unique device type 
within the nonVSAM entry is returned. Every 
nonVSAM volume occurrence is marked as prime. 


Outside the minimum unit count, all others in the 
nonVSAM entry are returned. 


User catalog entry (U): 


Within the minimum unit count, each volume in 
the user catalog entry that has a unique device type 
within the entry is returned. Every user catalog 
volume occurrence is marked as prime. 


Outside the minimum unit count, all others in the 
user catalog entry are returned. 


Base cluster entry (C): 


Within the minimum unit count, every volume that 
does not have sequence set with data is returned. 
Otherwise, same as data entry. 


Outside the minimum unit count, all others in the 
data entry are returned. 


Alternate index entry (G): 


Same as the base cluster entry, except that there is 
never an upgrade set. 


Alias path entry (R): 


Same as the base cluster entry, except that the 
upgrade set inclusion depends on the 
UPDATE/NOUPDATE flag in the path entry. 


C 


Normal path entry (R): 


Within the minimum unit count, every volume of 
the alternate index under this path is returned. 
Otherwise, same as the base cluster entry, except 
that the upgrade set inclusion depends on the 
UPDATE/NOUPDATE flag in the path entry. 


Outside the minimum unit count, all others in the 
data entry are returned. 
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Diagram DG3. SUPERLOCATE: List a Data Set’s Volume 
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Notes for Diagram DG3 


13 IGGOCLAA: IGGPSLR, IGGPSLIV, and IGGPSLY 


For each record obtained, IGGPSLEL extracts the 
volume information associated with the record. Then 
IGGPSLIV inserts the information into the caller’s 
work area. When the base cluster data record has been 
retrieved, IGGPSLY obtains any upgrade associations 
related to the record. 


14 IGGOCLAA: IGGPSLIV 
IGGOCLAM: IGGPSLEL 


IGGPSLIV inserts volume information into the 
caller’s work area. 


15 IGGOCLAA: IGGPSLY and IGGPSLIV 
IGGOCLAN: IGGPSLEL 


IGGPSLEL obtains the volume occurrences; 
IGGPSLIV inserts the volume information into the 
caller’s work area. 


16 IGGOCLAA: IGGPSLEN 


If the VSAM object is a base cluster data record, call 
IGGPSLY (IGGOCLAA) to obtain upgrade 
associations, if any. 


IGGOCLAM: IGGPSLEL and IGGPSLIV 


IGGPSLIV inserts volume information into the 
caller’s work area. 
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Diagram DG4. SUPERLOCATE® List a Data Set’s Volumes 


SRR 


- 17.. Move volume information to beginning of 


caller’s work area. 


18. Return to caller 


‘| 


CCAPROB 


Return Code 


CCA 
TCTGPL 
CTGPL 
tWork Area 


CTGWA 


TVol List 


CTGVL 


Volume Information 


€61 UoHesadO jo poyay 


C 


Notes For Diagram DG4 


IGGOCLAA: IGGPSLEN and IGGPSLIV 


17 IGGPSLIV builds the volume list from the end of the 
work area to the beginning, thus allowing the sorting 
of entries by device type both within and outside the 
minimum unit count. 


18 IGGOCLAM: IGGPSLOC 


If an error is detected, the procedure detecting the 
error returns control immediately to the calling 
procedure. IGGPSLOC returns to the caller of 
SUPERLOCATE. 


For additional information about topics related to 
SUPERLOCATE processing, see: 


“Data Areas:” 
Catalog record descriptions and formats 
‘Diagnostic Aids:” 


Catalog management return codes 
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Diagram DH1. UPDATE: Modify Catalog Information 
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Notes for Diagram DH1 


IDA0192A 


The VSAM Open routine uses VSAM catalog 
management to reset a VSAM data set. 


IDA0200T 


The VSAM Close routine uses VSAM catalog 
management to modify the data set and index statistics 
maintained in the catalog record’s copy of the 
AMDSB. 


IDA0557A 


The VSAM EOV routine uses VSAM catalog 
management to obtain more space for a data set. 


IGGOCLAB: IGGPACDV (calls IGGPUPD 
(IGGOCLAV)) 


When the caller issues the CATLG macro instruction, 
register | points to the caller’s catalog parameter list 
(CTGPL).The CTGPL request options are decoded 
and the base catalog record is retrieved for the 
request. See Diagram DBI, VSAM Catalog 
Management Overview, for a description of initial 
catalog management processing and request decoding. 


IGGOCLAV: IGGPUPD (calls IGGPUPDE 
(IGGOCLBB)) 


If more space is required for the data set, the 
UPDATE—Extend routine processes the caller’s 
update request, and returns to IGGPACDV in 
IGGOCLAB. 


IGGOCLAV: IGGPSFPL 


Steps 2 through 7 are performed to update each of the 
catalog record fields identified by the caller’s 
CTGFLs. 


IGGOCLAV: IGGPUPD (calls IGGPRUS (IGGOCLB7)) 


If a VSAM data set must be reset, the 
UPDATE-REUSE routine processes the caller’s 
request and returns to IGGPACDV (IGGOCLAB). 


IGGOCLAV: IGGPSFPL 


The caller’s CTGFL list contains the address of each 
CTGFL needed to satisfy the caller’s updating 
requirements. Each field parameter list (CTGFL) 
describes one of the catalog record fields to be 
updated. Each CTGFL is completely processed before 
the next one is started. 


C 


IGGOCLAV: IGGPSFPL (calls IGGPTSTS 
(IGGOCLBA)) 


Sometimes the caller wants to update a field only if 
another field’s value, when compared to the caller’s 
test value, satisfies the caller’s test conditions. If so, 
the caller builds a CTGFL that contains the name of 
the catalog field to be tested, the test conditions 
(equal, high, low, etc.), and the address and length of 
the caller’s test value. If a CTGFL contains the 
address of another CTGFL, the second CTGFL 
describes a catalog record field that is to be compared 
to the caller’s data. If the comparison satisfies the test 
conditions, the catalog record field specified by the 
first CTGFL is updated with the caller’s data. 


IGGOCLBA: IGGPTSTS and IGGPTCMP 


If the caller wants to update a catalog record’s header 
field, the field’s data is updated with the caller’s data if 
all tests are satisfied. 


If the caller wants to update a field from one of the 
sets of fields that follow the header field, the field’s 
data is updated with the caller’s data for each set of 
fields’ field that satisfies all tests. The set of fields that 
contains the field to be updated can also be identified 
by it’s sequence number. 


See ‘Data Areas” for details about the catalog record 
and its sets-of-fields. 


The sequence number of each set of fields that satisfies 
the tests is put in the CCA.When all sets of fields have 
been tested, the sequence numbers are used to identify 
each set of fields that contains caller-requested data. 


IGGOCLAX: IGGPALT2 


A combination name refers to a set of related catalog 
field names, and is used by the caller instead of a 
separate CTGFL for each field name. 


IGGOCLAX: IGGPALT2 


The CTGPL, CTGFL, and catalog control area (CCA) 
are described in “‘Data Areas.” 


The CCA’s combination name index has an entry for 
each field name in the combination. The Update 
routine processes each field name entry in the 
combination name index sequentially, starting with 
the index of the first field name entry for the 
combination, and ending when the number of entries 
processed equals the number of field names associated 
with the combination name. 


C 


The combination name’s CTGFL contains the 
beginning address and the total length of the group of 
update data fields in the caller’s work area. 


The test sequence (if any) associated with a 
combination-name CTGFL is done only once, not 
once for each field name in the combination. 


IGGOCLAV: IGGPSFPL (calls IGGPPREC 
(IGGOCLAW)) 


When the catalog record is updated (in a buffer in the 
Update routine’s virtual storage) the update routine 
sets the ‘must write” flag on to indicate that the buffer 
must be written from virtual storage into the catalog 
before the buffer can be made available to contain 
another catalog record. When the caller’s update 
request is finished, or when the Update routine needs 
the buffer to process another catalog record associated 
with the request, the Update routine calls IGGPPUPC 
or IGGPPAD (IGGOCLAG) to write the catalog 
record from the buffer into the VSAM catalog (on a 
direct-access storage device). 


See “Diagnostic Aids” for details about catalog 
management return codes and error codes. 
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Diagram DII. UPDATE-Extend: Obtain Additional Space for a VSAM Object 


Virtual Storage for the Caller’s Program Ce, Virtual Storage for the Caller’s Program 
Ril 
TCCA Catalog 
Management 
CCA Identifies the -————> 1. Retrieve the AMDSB set of fields to determine the CCA Buffer 


t Buffer sar eaiaraeece attributes and statistics. ALLPLAP> | Buffer Data Set Catalog 


Index Catalog Record 


; 

Record information ST Vorume 

tVolume 2. Find the volume information set of fields that ee 77 Set of Fields Information [ 
Information describes the volume to contain the additional a Set of Fields 
Set of Fields space. 

—_ 

Values SALPARL 


Low and 
High CCHH 
Values 
For Each 
Extent 
Allocated 


To the 


Catalog P Allocate space sorte data set ; 
Maharement Burst 3. Does the object share its VSAM data space with 


other VSAM objects? 
No Yes 


¥ 


CIl# of Object’s 
Catalog Record 


Amount of Space 
Requested 


Maximum Number 


if 


Data Space 


. Volume 
Set Allocation 


Information »y 4. Allocate space to the object from the data 


. Require- : 
Attribute a Sets of Fields space’s free space. (See Diagram DJ1, —>® VSAM Perea 
“SUBALLOCATE: Obtain Additional YA Object ow : 
Space from a Nonunique VSAM Data Space.’’) (D) 
5. Did the data space contain enough free Userlist 


space to satisfy the request? 
No Yes 


VY 


/ | 6. Can one of the data spaces on the volume identified VSAM Direct-Access 
in step 2 be extended to obtain the requested Volume 


amount of space? Co 
No Yes 


v Another VSAM Data 
Object Space #1 


Volume 


Serial 
Numbers 


SALPARL Userlist (A) hee 


: 7. Obtain another extent for the data space. 
(Chy—gr”_—s (See OS/VSI DADSM Logic, “Extending 
Data Set Allocations (Secondary Allocation).’’) D Ea ee Extent 
or ata 
(A) 8. Create anew VSAM data space on the volume. - Space #1 
(See OS/VSI DADSM Logic, ‘‘NonISAM Data 
Set Allocation.’’) Ew Data 
Extent #3 Space #2 


AY 
L c U 


L6| vonessdQ Jo poyieW 


C 


Notes for Diagram DI1 


The UPDATE-Extend routine is called whenever a 
VSAM object (cluster, data set, index, or catalog) needs 
more space to store it’s records. 


The VSAM end of volume routine calls the 
catalog-management UPDATE routine, and an amount 
of space, based on the object’s direct-access space 
allocation requirements, is allocated from one of the 
following sources: 


A shared VSAM data space that has enough free space 
to satisfy the allocation requirements 


A shared VSAM data space, extended to satisfy the 
allocation requirements from the free space on the 
object’s currently mounted volume 


A new VSAM data space, created to satisfy the 
allocation requirements, the object’s currently 
mounted volume. 


IGGOCLBB: IGGPUPDE (calls IGGPINIT 
(IGGOCLBC)) 


IGGOCLBB: IGGPUPDE (calls IGGPSVOL 
(IGGOCLBC)) 


The volume information set of fields is identified by 
volume serial and key ranges, if this is a key-range 
data set. See ““Data Areas”’ for details about the 
volume information set of fields. 


IGGOCLBB: IGGPUALL 


A shared (nonunique) VSAM data space contains all 
or parts of two or more VSAM objects. A unique 
VSAM data space contains all or part of only one 
VSAM object, and is not allowed to contain records of 
another object. 


IGGOCLBB: IGGPCSAL (calls IGGPSALL 
(IGGOCLAR)) 


If the object shares its data space with other VSAM 
data sets or indexes, there might be enough free space 
in one of the data spaces on the volume to satisfy the 
object's direct-access space allocation requirements. 


IGGOCLBB: IGGPUPDE 


If there is not enough free space, another extent is 
obtained for one of the volume’s data spaces, or a new 
data space is created. 


IGGOCLBB: IGGPUPDE 


If any data space on the volume has less than 12 
extents, the data space can be extended. 


IGGOCLBB: IGGPUPDE 


If a new extent was obtained for one of the volume’s 
data spaces or a new data space was created, this 
space is suballocated to the object (nonunique) or 
given directly to the object (unique). For recoverable 
catalogs, the format-4 timestamp field is updated on 
the physical volume. 
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Diagram DI2. UPDATE-Extend: Obtain Additional Space for a VSAM Object 
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Notes for Diagram DIZ 
11 IGGOCLBB: IGGPMVOL 


If a key range data set obtains space from a candidate 
volume, the second, third, fourth,... key range that 
obtains space from that candidate volume for the first 
time will require a new volume information set of 
fields. Note that each key range or each different 
volume is described by an individual volume 
information set of fields. 


12 IGGOCLBB: IGGPMVOL 


The object’s catalog record contains a volume 
information set of fields to describe the object’s space 
on each volume that contains a part of the object. If 
the object’s newly obtained extent is in a key range on 
a new volume, the UPDATE-Extend routine may 
build a volume information set of fields to describe the 
new volume and extent. Otherwise, an existing volume 
information set of fields is updated with the 
high-allocated RBA and extent information in the 
form: 


SS CCHH CCHH DDDD DDDD 
where: 
« SS identifies the VSAM data space. 


« CCHH are the low and high cylinder and track 
addresses. 


« DDDD are the low and high RBAs. 


See ‘Data Areas” for details about the object’s catalog 
record, and its for volume information set of fields. 


16 IGGOCLBB: IGGPSSWD 


The low and high CCHH addresses (in the index 
catalog-record’s volume information set of fields) are 
those of the extent obtained for the data set. The low 
and high RBA values are for the sequence set. 


18 


See “‘Diagnostic Aids” for details about catalog 
management return codes and error codes. 
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Diagram DI3. REUSE: Reset a VSAM Data Set 
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Notes for Diagram DI3 


REUSABLE is an attribute that may be assigned to a 
VSAM data set or an alternate index. This attribute 
allows the data set to have its high-used RBA set to 
zero at open time, if the user specifies the RESET 
option. The indicator for REUSE is retained in the 
attributes field of data and index records of a 
key-sequenced data set and an alternate index and in 
the data record of an entry-sequenced and relative 
record data set. Reusable data sets may be 
multi-volumed and they must be suballocated only. 
That is, reusable data sets may not be unique. Also, 
reusable data sets cannot have key ranges and they are 
restricted to a maximum of 16 physical extents per 
volume. If a base cluster is defined as reusable, it may 
not have alternate indexes associated with it; however, 
it is permissible to define reusable alternate indexes 
that are related to a nonreusable base cluster. 


1 IGGOCLAV: IGGPUPD (calls IGGPRUS (IGGOCLB7)) 


Initially, the data set catalog record is available in a 
catalog management buffer. 


4 If the data set is not reusable but is empty, the caller’s 
LOCATE request is processed. No error codes are 
returned. 


8 IGGOCLB7: IGGPRUS (calls IGGPEXT (IGGOCLAZ)) 


The reuse work area is set up by IGGPRUS and 
appropriate pointers are initialized. The reuse work 
area includes CTGPL and CTGFLs required by 
Modify and Extract Logic. 
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Diagram DI4. REUSE: Reset a VSAM Data Set 
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Notes for Diagram DI4 
12 IGGOCLB7: IGGPRUS (calls IGGPEXT (IGGOCLAZ)) 


The reuse work area provides space for a volume 
information set of fields that contains a maximum of 
16 extent descriptors. 


13 IGGOCLB7: IGGPRUS (calls IGGPGET (IGGOCLBD) 
17 IGGOCLB7: IGGPRUS (calls IGGPMOD (IGGOCLAV)) 
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Diagram DI5. REUSE: Reset a VSAM Data Set 
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Notes for Diagram DI5 


19 The flag field in the volume information set of fields 
indicates whether sequence set is with data. If so, no 
resetting of the space map is necessary, since the space 
map will have been set already from the corresponding 
data set volume information set of fields. This is also 
true for the relative track sum in the case of a 
recoverable catalog. 


21 IGGOCLB7: IGGPRUS (calls IGGPSSCR (IGGOCLBF)) 
23 IGGOCLB7: IGGPRUS (calls IGGPTNXO (IGGOCLBD) 


If the reset volume is a candidate volume, the 
computed sum in the CCA will be zero. 
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Diagram DI6. REUSE: Reset a VSAM Data Set 
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28. Move updated AMDSB sets of fields and 
updated header information to catalog. 


29. Is a key-sequenced data set being processed? 
No Yes 


30. Read index catalog record into catalog 
management buffer, replacing the data 
set catalog record. 


. Repeat steps 8 through 28 for the index 
component of the data set. 


. Restore the data set catalog record 
into the catalog management buffer. 


‘ CCAPROB 


33. Return to caller. E22) Return Code _ 
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Notes for Diagram DI6 

28 IGGOCLB7: IGGPRUS (calls IGGPMOD (IGGOCLAYV)) 
30 IGGOCLB7: IGGPRUS (calls IGGPGET (IGGOCLBD) 
32 IGGOCLB7: IGGPRUS (calls IGGPGET (IGGOCLBD) 
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Notes for Diagram DJ1 


The Suballocate routine is called to assign a candidate 
volume to a VSAM object (cluster, data set, index, or 
catalog) and to assign available space to a VSAM object 
from one of the data spaces on the caller-specified 
volume. The caller, either the UPDATE-Extend routine 
(see Diagram DI1) or the DEFINE CLUSTER routine 
(see Diagram ED1), builds a list of volume serial numbers 
to identify each volume to be assigned to the object as a 
candidate volume. If the caller requests space allocated to 
the object, the list contains one volume serial number. 


1 IGGOCLAR: IGGPSALL 


The volume entry record may already exist in the 
RAB, having been put there by the caller of 
suballocate. 


2 ICCOCLAR: ICCPSALL 


If the volume entry record is not in the RAB, a call is 
made to IGGPGET (BI) to get the record. 


4 IGGOCLAR: IGGPSALL 


If the request is to assign available space to an object 
from a specified volume, IGGPSALL calls 
IGGPSALS (AU). 


5 IGGOCLAR: IGGPSALL 


If the volume catalog record already contains a data 
set directory entry set of fields, the volume either is 
already assigned to the VSAM object as a candidate 
volume or has some of its space allocated to the 
VSAM object. 


6 IGGOCLAR: IGGPSALL 


If a Directory Entry already exists for the data set, the 
return code is set in the user-provided volume serial 
number list. 


7 IGGOCLAR: IGGPSALL 


IGGPSALL calls IGGPISCJ and IGGPMOD to add 
the new data set directory entry to the volume catalog 
record. 


See “‘Data Areas” for details about the data set 
directory entry set of fields. 
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Diagram DJ2. SUBALLOCATE: Obtain Additional Space from a Nonunique VSAM Data Space 


Virtual Storage for the Caller’s Program 


Work Area 


Number of 
Tracks/Cylinder 
Requested 


Extent Table TTNN 
Value 


Return from 
IGGPBMR 
Extent Save Area/ 
Small Extent Table 
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Space Map Data Space Group 
Sets of Fields 


CF Process the Request for more Space 


-—-----|”? satisfy the request. 


r—---l> 10. Buttd an extent table to show all nonunique 


9. Determine the amount of tracks required to 


(shared) data space extents on the volume. 


If the extent obtained by step 10: 


12. Exactly satisfies the request, no further 
extent-table processing occurs. 


13. Is greater than the amount of tracks requested, if a 
previous “‘larger extent”? was found and if the 
currently obtained extent is smaller than the pre- 
viously obtained one, the current extent is saved. 


14. Is less than the amount of tracks requested, save it. 


Allocate the Space to the Object 


15. Requested space found? 
Yes No 


CCAPROB 


16. Return to caller. exzzm>| Error code | 


17. Reset the Space Map set of fields to show the 
newly allocated tracks. 


18. Return to caller. 


NAY 


11. Examine the Space Map set of fields —-———]J—— 


a a 


Virtual Storage for the Caller’s Program 
RII 


CCA 


tWork Area 
t Buffer Work Area 


Extent Save Area/ 
(Ey Small Extent Table 
Data Space 
Extent Table 


Volume Catalog Record 


Buffer 


Parameters to IGGPBMR 


Minimum 
Allocation 
Unit Size 


Starting TT 
Value of Extent 


Ending TT Value 
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Notes for Diagram DJ2 
9 IGGOCLAU: IGGPSALS 


If the amount of space requested is a number of 


request, no further extent table processing is done. 
Larger or smaller extents obtained from previous 
extent-table entries are ignored. 


13 IGGOCLAU: IGGPEDS 


indicator) TT, turning off NN bits (NN is the exact 
number of tracks required to satisfy the request). 


If the space is allocated to an object from a number of 


[IZ wonersdg jo poy 


cylinders, convert it to a number of tracks. 


10 IGGOCLAU: IGGPSALS (calls IGGPEXT (IGGOCLAZ)) 


The extent table is built by retrieving each extent 
descriptor (from each data space group set of fields) 
that might contain enough free space to satisfy the 
request’s minimum allocation requirement (the 
number of tracks in one control area). 


All extents of shared data spaces are described in the 
table until either there are no more extents to describe 
or the table is full. If the table is full, step 10 is repeated 
when steps 11 through 14 are completed, until the 
extents of all shared data spaces have been examined. 


11 IGGOCLAU: IGGPEDS (calls IGGPBMR (IGGOCLBR)) 


Each extent descriptor in the extent table is in the 
form: 


S# TT NN 
where: 


e S# is the sequence number of the data space’s 
extent. 


e TT is the extent’s starting track number. 
e NN is the number of tracks in the extent. 


The extent descriptors are processed beginning with 
the lowest TT value in the table, then the next lowest, 
etc., until all extent descriptors have been processed. 


IGGPBMR examines each extent to find an amount of 
contiguous unallocated tracks at least as large as the 
request’s minimum allocation unit. |IGGPBMR 
examines the Space Map set of fields, starting at bit 
position (track indicator) TT and ending at bit 
position (track indicator) TT+NN-1 (usually the 
extent’s track boundaries). If IGGPBMR finds a large 
enough amount of unallocated tracks, it returns to 
IGGPEDS with the beginning track number (TT) and 
the number of tracks (NN). If the data space’s extent 
might contain another amount of unallocated tracks at 
least as large as the request’s minimum allocation unit, 
IGGPEDS calls IGGPBMR again to examine the rest 
of the data space’s extent. 


12 IGGOCLAU: IGGPEDS 


If the extent returned by IGGPBMR is the exact 
number of tracks required to satisfy the caller’s 


If the extent returned by IGGPBMR is larger than the 
amount of tracks required to satisfy the request, the 
extent is saved if either: 


e No other “larger-than-requested-amount” extent 
has been returned yet, or 


e The current extent is smaller than a previously 
obtained “‘larger-than-requested-amount” extent. 


MONDAY AUG 23 - merged TNL with base (parts 1 and 
2) and sent to printq. 


In either case, only one 
““larger-than-requested-amount” extent value is saved. 
The ‘‘small extent table” (built in step 13) is ignored 
and no longer used. 


14 IGGOCLAU: IGGPEDS 


If the extent returned by IGGPBMR is smaller than 
the amount of tracks required to satisfy the request, its 
TTNN value is adjusted so that TT is on a cylinder 
boundary. If NN is now at least as large as the 
request’s minimum allocation unit (number of tracks 
for one control area), the extent is saved in the ‘“small 
extent table” if: 


e The table has fewer than five entries (or a 
caller-specified maximum less than five), or 


¢ The table is full and the current extent’s NN value 
is greater than the table’s smallest extent’s NN 
value. The current extent replaces the table’s 
smallest extent. 


In either case, the extent is not put in the “‘small extent 
table” if it is too small (adjusted NN is less than the 
minimum allocation unit) or if a 
““‘larger-than-requested-amount” extent already exists 
(see step 12). 


If, after all data spaces have been examined, the total 
of the NN values in the “‘small extent table” is less 
than the amount required to satisfy the request, no 
space is allocated to the object. 


17 IGGOCLAU: IGGPSALS (calls IGGPBMR 


(IGGOCLBR)) 


If the selected extent is larger than or equal to the 
amount of space requested, IGGPBMR adjusts the 
Space Map set of fields starting at bit position (track 


extents, the “‘small extent table” is sorted so that the 
largest NN value is first, the smallest last. |IGGPBMR 
then adjusts the Space Map set of fields for each 
TTINN value in the “‘small extent table,” until the 
amount of allocated tracks equals the amount of tracks 
requested. 


18 IGGOCLAU: IGGPSALS 


IGGPSALS returns the sequence number of the data 
space’s extent, starting track number, and number of 
tracks for each extent obtained for the request. The 
caller uses this information to build extent descriptor 
entries in the VSAM object’s volume information set 
of fields. 
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Diagram DK1. LSPACE: Build an “‘Available Space”’ Report 


Virtual Storage for the Caller’s Program Virtual Storage for the Caller’s Program 


> 1. Obtain VSAM data space information for all data 
ee. spaces on the volume. (See Diagram DL1, “Obtain 
Request 
Type 


CCA 


TCTGPL 
t Buffer 


a Catalog Record Field’s Value.’’) 


. Build an available-space report by deriving the 
available-space information of each data space entry 
in the volume catalog record. 


tWork Area 


TCTGPL 


t Buffer 


. Did the caller provide a work area? 


Yes Catalog 
Virtual Storage for the LSPACE Management 
Routine’s Buffer Buffer 
Volume Catalog Record 4. Did an error occur while building the Volume 
i 5 Catal 
Data Space Entries available-space report? = alog 
ecord 
No Yes 


30-Byte 
Work Area 


¥ 


5. Put a diagnostic message into the 
caller’s work area. 


Available-Space 
Data for One of 
the Caller’s 

Volumes 


x 


6. Put the available-space report into the caller’s 
work area. 


7. Does the OS/VS system include the system 


management facilities (SMF)? 
No Yes 


SMF Data Set 


Volume 
Catalog 
Record 


8. Write SMF record type 69 — VSAM Data 
Space Information. 


CCAPROB 


9. Return to the caller. (i2e ewe Return Code 
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Notes for Diagram DK1 


1 


IGGOCLBK: IGGPLSP and IGGPLDCE 


The volume catalog record describes each VSAM data 
space, and its free space, on the volume. 


See ‘‘Data Areas” for details about the volume catalog 
record. 


IGGOCLBK: IGGPLDCS, IGGPLSMS, IGGPLDAS 


Each data space entry derived from the volume 
catalog record has a field that describes the available 
space in the data space. The LSPACE routine analyzes 
each data space entry and calculates the amount of 
available space in cylinders and tracks. It also records 
the number of cylinders and tracks in the longest 
continuous amount of available space. 


IGGOCLBK: IGGPLEMP 


A diagnostic message describing the error which 
occurred during the building of the available-space 
report is placed in the caller’s work area. 


IGGOCLBK: IGGPLDCE, IGGPLSMP 


If the caller provides a 30-byte work area, the 
available-space report is put into the work area in the 
form: 


SPACE-CCCC,TTTT,AAAA/cccc, tttt 
where: 


*« CCCC is the number of cylinders of free space in 
all VSAM data spaces on the volume. 


« TTTT is the number of tracks in addition to the 
number of cylinders of free space in all VSAM data 
spaces on the volume. 


* AAAA is the number of extents of free space in all 
VSAM data spaces on the volume. 


e cccc is the largest number of contiguous freespace 
ce cylinders on the volume. 


° tttt is the number of contiguous free-space tracks in 
addition to the cccc value. 


IGGOCLBK: IGGPLSP (calls IGGPSMFL (IGGOCLBV)) 


See OS/VS System Management Facilities (SMF) for 
SMF record type 69 details. 


IGGOCLBK: IGGPLSP 


See ‘Diagnostic Aids” for details about catalog 
management return codes and error codes. 
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Diagram DL1. Obtain a Catalog Record Field’s Value 
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@ The sequence number in the pointer equals the 
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5. Were step 4’s conditions satisfied by one of the 
record’s set-of-fields pointers? 


Yes No 


—-—— —|> 


ie SSS SS SS 6. Is there an extension record for the catalog 
record examined in step 4? “Not Found” Flag 
Yes No 


v CCAPROB 


| 7, Return to the caller, ZZz2zeg Return Code 


Attempt to read the extension record into a catalog 
management buffer. 


8. Is a buffer available to contain the extension 
record? ‘‘No Buffer 


Yes No Space” Flag 
¥ CCAPROB 
9. Return to the caller. 222 


10.Read the extension record into a catalog 
management buffer. (See Diagram BC], 
““GET-Direct Processing: Direct Retrieval.’’) 


<> Return Code 


Virtual Storage for the Caller’s Program 
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Notes for Diagram DL1 


The Get-Field-Value routine is called by other catalog 
field management routines to obtain the location and 
length of a field in a catalog record. The record is in 
virtual storage in a catalog management buffer. The 
following results could occur: 


¢ The field is entirely contained in the record in the 
buffer, and the field’s address and length are set in the 
caller’s CCA. 


¢ The field is partially contained in the record in the 
buffer, and the field’s address and partial length are 
set in the caller’s CCA. The CCA also has the “‘not 
complete” flag on and contains the control-interval 
number of the catalog record’s extension, which 
contains more of the field. 


e The field is not retrieved because it doesn’t exist in the 
caller-specified set of fields, or because there are no 
more sets of field in the record, or because no buffer 
space is available to contain an extension record. 


1 IGGOCLBS: IGGPXVAL 


If the field name is derived, the field information to be 
returned does not exist in the physical catalog record 
but must be generated from the catalog fields, possibly 
in different catalog records. Derived field names exist 
only in the volume entry. 


2 IGGOCLBA: IGGPLVAL 


The field-name dictionary is a read-only catalog 
management table. The catalog field name dictionary 
contains an entry for each type of catalog record field, 
based on it’s field name. The caller puts the dictionary 
entry identified by the CTGFL’s field name into the 
CCA before calling the get-field-value routine. 


Header fields are identified by a type-code of 0 (in 
their dictionary entry). A nonzero type-code identifies 
a set of fields that contains the field identified by the 
CTGFL’s field name. 


See “‘Data Areas” for details about the catalog field 
names and dictionary entry format. 


3 IGGOCLBA: IGGPLVAL 


Header fields are fixed-length and located at a fixed 


displacement from the beginning of the catalog record. 


The field’s address is obtained by adding the 
displacement (in the CTGFL’s dictionary entry) to the 
beginning address of the record (the CCA’s CCACPE1 
value). The field’s length is part of CTGFL’s 
dictionary entry. 


C 


If the field name identifies a header field, and the field 
is variable length, the field’s address is obtained by 
using the sequence number in the CTGFL’s dictionary 
entry, which indicates that the field is the first, second, 
etc. variable-length field. 


See ‘Data Areas” for details about the catalog record 
header fields and the catalog communications area 
(CCA). 


IGGOCLBA: IGGPLVAL 


The set of fields pointer (GOP) is used to locate a set 
of fields. The GOPs are grouped together by type 
code. Within each group of GOPs, the pointers are 
ordered by sequence number. 


See “Data Areas” for details about the catalog record 
and set of fields pointer. 


IGGOCLBA: IGGPLVAL 


If the caller-specified set of fields pointer identified by 
it’s sequence number is found, its displacement field 
and flags field specify the location of its set of fields 
as: 


¢ the number of bytes from the beginning of the 
record’s sets of fields (the CCA’s CCACPE3 value 
plus the set-of-fields pointer’s displacement field 
value), or 


¢ the control interval number of the extension record 
that contains the set of fields. The extension record 
contains a set-of-fields pointer that specifies the set 
of field’s location as a number of bytes from the 
beginning of the record’s sets of fields. 


See ‘Data Areas” for details about the catalog record, 
extension record, and set of fields pointer. 


IGGOCLBA: IGGPGVAL 
IGGOCLBA: IGGPGVAL 


See ‘‘Diagnostic Aids” for details about catalog 
management return codes and error codes. 


IGGOCLBA: IGGPGREC 


Each catalog record (in a catalog management buffer) 
is identified by a record area block (RAB) within the 
CCA. The RAB contains flags that indicate whether or 
not the buffer can be used to contain another record. 
If the RAB’s ‘‘must write” flag is on, the buffer cannot 
be used for another record until its contents have been 
written into the catalog. 


See ‘‘Data Areas” for details about the CCA. 


c 


IGGOCLBA: IGGPGVAL 


Each catalog control area (CCA) contains six record 
area blocks. Each catalog management request can use 
a maximum of five buffers. If all buffers are filled and 
cannot be released, the get-field-value routine sets the 
CCA’s ‘“‘no buffer space” flag on. 


9 IGGOCLBA: IGGPGVAL 


See ‘‘Diagnostic Aids” for details about catalog 
management return codes and error codes. 


10 IGGOCLBA: IGGPGREC 


The CCA’s “not found” flag is set off before returning 
to step 3 to examine the extension record’s set of fields 
pointers. 
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Diagram DL2. 


Ni 


11. 


No 


Virtual Storage for the Caller’s Program 


t Buffer 


Buffer 
Usage 
Flags 


| Record 
| Record Ss 
CI# 


tCatalog 
Record 
Field 


Catalog Management 
Buffer 


| | 


18. 


19. 


Obtain a Catalog Record Field’s Value 
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[é 


Locate the field in the buffer and set the field’s address 
and length. 
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extension record? 
No 


q 


17. Return to the caller. 


CCAPROB 


[ee@em Return Code 


Set the extension record’s control interval number in 
the CCA. 


Return to the caller. 


CCAPROB 
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Notes for Diagram DL2 
11 IGGOCLBA: IGGPLVAL 


If the set of fields pointer contains the control interval 
number of an extension record, the set of fields is in 
that extension record. 


12 IGGOCLBA: IGGPGVAL 
IGGOCLBA: IGGPGREC 


Each catalog record (in a catalog management buffer) 
is identified by a record area block (RAB) within the 
CCA. The RAB contains flags that indicate whether or 
not the buffer can be used to contain another record. 
If the RAB’s “must write” flag is on, the buffer cannot 
be used for another record until its contents have been 
written into the catalog. 


See ‘“Data Areas” for details about the CCA. 
IGGOCLBA: IGGPGVAL 


Each catalog control area (CCA) contains six record 
area blocks. Each catalog management request can use 
a maximum of five buffers. If all buffers are filled and 
cannot be released, the get-field-value routine sets the 
CCA’s “‘no buffer space” flag on. 


13 IGGOCLBA: IGGPGVAL 


See ‘‘Diagnostic Aids” for details about catalog 
management return codes and error codes. 


14 IGGOCLBA: IGGPGREC 


The CCA’s “‘not found” flag is set off before returning 
to step 3 to examine the extension record’s set of fields 
pointers. 


15 IGGOCLBA: IGGPLVAL 


The field’s length is obtained from the CTGFL’s 
dictionary entry (for a fixed-length field) or the first 2 
bytes of the field (length bytes of a variable-length 
field). The field’s address is the sum of the address of 
the set of fields and the displacement in the CTGFL 
(for a fixed-length field); or is first, second, etc. (as 
indicated in the CTGFL) for a variable-length field. 


16 IGGOCLBA: IGGPLVAL 


A variable-length field might be partially contained in 
an extension record. If so, the field’s length is greater 
than the number of bytes remaining in the record. 


17 IGGOCLBA: IGGPLVAL 


See “Diagnostic Aids” for details about catalog 
management return codes and error codes. 


c 


18 IGGOCLBA: IGGPLVAL 


The caller’s information requirements might be 
satisfied with the part of the field that is currently 
available. If not, the caller (a catalog management 
routine) returns to the get-field-value routine to obtain 
the next part of the field from the extension record. 


19 IGGOCLBA: IGGPLVAL 


The caller can move that part of the field currently in 
the buffer into a work area. If the rest of the field is 
required, the caller can return to the get-field-value 
routine to retrieve the extension record. 


See ‘Diagnostic Aids” for details about catalog 
management return codes and error codes. 
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Diagram DM1. Modify a Catalog Record Field’s Value 
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tSet 
Flags| of | GTOUP| Sea-| Irieial | Field 9. Move the caller’s data into the record, updating 
Fieldd Code | # isti 
, existing data in the set of fields. 


10. Are there more CTGFLs to process? 


CPE5 CPE6 Yes No 


(tCurrent Set- (tCurrent 
of-Fields Pointer) Set of Fields) cy 


11. Process the next CTGFLam>G) 


c c c 


6IZ UOHeedg jo poy 


C 


Notes for Diagram DM1 


1 IGGOCLAV: IGGPMOD (calls IGGPXMOD 
(IGGOCLBT)) 


For newly-created volume entries, deleted set-of-fields 
pointers are inserted for the bit map set of fields to 
ensure that the base volume entry (V) contains the bit 
map set-of-fields pointers. This bit map set of fields is 
dynamically added when the first data space set of 
fields is added. 


2 IGGOCLAV: IGGPMOD (calls IGGPSCNC 
(IGGOCLAY)) 


Each CTGEL is initialized with the dictionary entry 
associated with the CTGFL’s field-name value. 


3 IGGOCLAV: IGGPMOD (calls IGGPSFPL 
(IGGOCLAV)) 


The field parameter list (CTGFL) contains the field’s 
name, type code, length, and displacement from the 
beginning of the record or set of fields in the case of a 
fixed-length field. For a variable-length field, contains 
the field’s name, type code, and sequence number. If 
the field exists, it is either a header field (group code = 
0) or a field within a set of fields. If the caller supplied 
modifying data and test conditions, the field is being 
altered. If the caller supplied modifying data and no 
test conditons, a set of fields is to be added to the 
record. If the caller identified a set of fields 
combination field-name but didn’t supply modifying 
data, the set of fields is being deleted. 


4 IGGOCLAV: IGGPSFPL (calls IGGPXDGO 
(IGGOCLBT) which in turn calls IGGPADGO 
(IGGOCLAW)) 


Every new set of fields is examined by the 
derived-field processing routine (IGGPXDGO) before 
being passed on to the normal add field processing 
routine (IGGPADGO). The derived-field processing 
routine ensures that certain volume set of fields are 
never added, added in a different format, or cause 
dynamic addition of a different set of fields (i.e., bit 
map set of fields). 


5 IGGOCLAV: IGGPAGOP 


If a new set of fields pointer is built, it is put into the 
catalog record at the end of its group of set-of-fields 
pointers. The set-of-fields pointers are grouped by type 
code with the codes in sequence number order. 


If the new set of fields pointer causes the catalog 
record to overflow, an extension record is obtained 
from the catalog’s free control intervals. All sets of 


C 


fields in the original record are put into the extension 
record. The set-of-fields pointer’s displacement value 
(in the original record) is replaced with the control 
interval number of the extension record. In addition, a 
set-of-fields pointer is built and put into the extension 
record for each set of fields in the extension record. 
The set-of-fields pointer in the extension record 
contains the displacement from the beginning of the 
record to its set of fields. 


If the new set of fields pointer causes the catalog 
record to overflow and the catalog record contains 
only set-of-fields pointers, an extension record is 
obtained to contain the new set-of-fields pointer. The 
original record’s extension field contains the control 
interval number of the extension record. 


IGGOCLAW: IGGPAGOP (calls IGGPIGOP 
(IGGOCLAW)) 


The Modify routine activates the set of fields pointer 


by setting it’s “inactive” flag off. 


See ‘‘Data Areas” for details about the catalog record 
and set of fields pointer. 


IGGOCLAW: IGGPADGO 


See ‘“Data Areas” for details about the set of fields 
pointer. 


IGGOCLAW: IGGPADGO (calls IGGPMVGD 
(IGGOCLAW)) 


The new set of fields might contains fixed-length fields 
and variable-length fields. 


If the new set of fields causes the record to overflow, 
an extension record is obtained to contain the new set 
of fields. 


See ‘Data Areas” for details about the catalog record 
and its sets of fields. 


IGGOCLAW: IGGPADGO (calls IGGPMVGO 
(IGGOCLAW)) 


Replace the initial field values (from step 6) with the 
caller-supplied values addressed by the CCA. 


10 IGGOCLAV: IGGPSFPL 


If there are no more CTGFLs to process, calls 
IGGPPREC to write each updated catalog record into 
the catalog. 


11 IGGOCLAV: IGGPSFPL 
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Diagram DM2. Modify a Catalog Record Field’s Value 
Virtual Storage for the Caller’s Program Change a field within a set of fields: Virtual Storage for the Caller’s Program 
Ri 12. Obtain the field’s length and displacement from the 


TCCA 
CCA 
TCTGFL 


tCatalog 
Record 


Set-of-Fiel 


Sequence 
Number 


Addresses 


of Parts of 


the Catalo 
Record in 
the Buffer 


Set-of-Fiel 
Pointers, 


(tCurrent 


Set-of-Fields Set of 


Pointer) 


beginning of the record or sequence number (for 
variable-length fields), and the length and address 
ef the field’s updating data. 

13. Is fixed-length field being modified? 


¥ Yes 


14. Replace the field’s existing data with the 
updating data. 


ds 


and data. 


If the field’s length is: 

Reduced: 

16. Shift the other fields to the left by the number 
of eliminated bytes. 

Increased: 

17. Shift the other fields to the right by the number 

of additional bytes. 


B 


Data to Update 
the Field With 


\ 


a’. 


ASEDASASASESESERSERERESARERRERESEERDS' 


Catalog Record 


ds Obtain an extension record 


18. Can the record’s freespace contain the new or VSAM Catalog 


updated set-of-fields’ field? 
Yes 


; ; Extension 
. Assign a free record as an extension to the catalogr~—— > Other Part 
record. New Set-of- | of the 


. Move the original record’s data from the original Fields Original 
: : . : Pointers 
into the extension until there is enough freespace 
in the original record for the expansion. 


Part of the 
Original Free- 
Record’s |space 
Data 


Updated 
Set-of-Fields 
Pointers 


No 


Original 
Record 


(tCurrent 


Fields) 


CPE7 (tCurrent Field) 


Free- 


VSAM Catalog 
space 


21. Update all set-of-field pointers that are affected pyyxxy> 
by the split. 


Free 
Catalog 
Records 


Cc 


Notes for Diagram DM2 
12 IGGOCLAV: IGGPSFPL (calls IGGPXLT2 (IGGOCLBT) 


which in turn calls IGGPALT2 (IGGOCLAX)) 


Every field to be updated is examined by the 
derived-field processing routine (IGGPXLT2) before 
being passed on to the normal update field processing 
routine (IGGPALT2). The derived-field processing 
routine ensures that certain volume entry set of fields 


C 


19 IGGOCLAX: IGGPALT2 (calls IGGPAOCI 


(IGGOCLAG)) 


The catalog control record (CCR) contains the 
control-interval number of a free control interval. 
Catalog management allocates the free control 
interval to the original catalog record as an extension 
record. The control-interval number of the next free 
control interval is put into the CCR, and the CCR’s 
free control interval count is decreased by 1. 


17Z wonelsdg jo poumpy 


are never altered, primarily because the altered fields 
do not physically exist in the catalog records. 


IGGOCLAX: IGGPALT2 (calls IGGPGVAL (IGGCLBA)) 


The CCA’s CCACPE7 field contains the field’s 
address. The CTGFL contains the address and length 
of the data to update the field with. 


13 IGGOCLAX: IGGPALT2 


The CTGFL flags field (from the catalog field name 
directory) specifies field type. 


See ‘“‘Data Areas” for details about the CTGFL. 
14 IGGOCLAX: IGGPALT2 


The CTGFL contains the length and address of the 
updating data. The data is in the caller’s work area. 


15 IGGOCLAX: IGGPMVAR 


The CTGEFL flags field (from the catalog field name 
directory) specifies field type. If the length of the data 
to update the field with (in the CTGFL) isn’t equal to 
the field’s length (in the CCA), the variable-length 
field’s length is either increased or decreased, causing 
a corresponding reduction or increase in the catalog 
record’s amount of free space. 


20 IGGOCLAX: IGGPALT2 


The set of fields’ data is split so that part remains in 
the original record and part is moved into the 
extension record. 


21 IGGOCLAX: IGGPALT2 


Each set of fields pointer is updated to show the new 
position of its set of fields. 


The variable-length field’s length bytes are replaced 
with the length of the data to update the field with (in 
the CTGFL). 


16 IGGOCLAX: IGGPSHNK 


The eliminated bytes at the end of the record are 
added to the record’s free space. 


17 IGGOCLAX: IGGPEXPD 


The additional bytes are obtained by reducing the 
record’s free space. 


If the increased length causes the catalog record to 
overflow, an extension record is obtained. The 
original record’s data is split so that part remains in 
the original record and part is moved into the 
extension record. Each associated set of fields pointer 
is updated to show the new position of its set of fields. 
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Diagram DM3. Modify a Catalog Record Field’s Value 


Virtual Storage for the Caller’s Program 
Delete a set of fields: 


22. Deactivate the set-of-fields pointer. 


Release an extension record 


23. Is the deleted set of fields the only one in an 
extension record? 


Yes No 


Ic 


Delete the extension record’s control interval number >. 
from the record that the extension record extends. 


Virtual Storage for the Caller’s Program 


Oe 


—_ 


Buffers 


t Updated Updated 
Catalog Catalog 
Record Lg Record 

t Extension / JjExtension| EX 
Record Record 


25. Update the extension record to reclassify it as 
a free catalog record. 


. Update the catalog control record to show one 
more free record. 


ay” 


Nee 


-of-Fi ; 27. Write the updated catalog record from the buffer 
r CCAPROB 


VSAM Catalog 


Control 
Record 


Catalog 
. Records 


R11 


CCA Buffer 


t Buffer Catalog Record 


Set-of-Fields| cots of Fields 
Pointers 


Ee 


Set-of- Fields 
Pointer 


Flag: Displacement 
Inactive | Set to 0 


Freespace 


Catalog Record Being Updated 


Set-of- Fields 
Pointer 


tExtension 
Record 
Set to 0 


Extension Record 


Identifier tNext Free 
Shows Catalog 
Free Record Record | 


Updated 
Catalog Records 
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Notes for Diagram DM3 


21 IGGOCLAV: IGGPSFPL (calls IGGPXEL2 
(IGGOCLBT)) which in turn calls IGGPDEL2 
(IGGOCLAV)) 


Every set of fields to be deleted is examined by the 
derived field processing routine (IGGPDEL2) before 
being passed on to the normal delete set of fields 
processing routine (IGGPDEL2). The derived field 
processing routine ensures that certain nonexistent 
sets of fields are not deleted and that the bit map set of 
fields is updated. 


IGGOCLAV: IGGPDEL2 


The set of fields pointer’s “inactive” flag is; set on, 
thereby deactivating it. The set of fields pointer’s type 
code and sequence number fields are unchanged. The 
set of fields is removed from the record and the 
displacement field is set to 0, if the field is in the same 
record as the set-of-fields pointer; otherwise, the 
following is done: 


23 IGGOCLAV: IGGPDEL2 


If the extension record contains no data after the set of 
fields is removed, the record is reclaimed by catalog 
management as a free control interval. 


25 IGGOCLAV: IGGPDEL2 
See “‘Data Areas” for details about the catalog record. 
26 IGGOCLAV: IGGPDEL2 


The catalog control record (CCR) contains the count 
of free control intervals available to the catalog and 
the control interval number of a free control interval. 
All free control intervals are chained together. When a 
control interval is added to the free control interval 
chain, catalog management puts the CCR’s free 
control interval number into the new free control 
interval and puts the new free control interval’s 
control-interval number into the CCR. The CCR’s 
free-control-interval count is increased by 1. 


See “Data Areas” for details about the catalog record 
and the extension record. 


27 IGGOCLAV: IGGPMOD 
28 


The modify routine returns to the caller (a catalog 
management routine) when the catalog record field is 
updated. 


See “Diagnostic Aids” for details about catalog 
management return codes and error codes. 
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Diagram EA1. Catalog Management Services Table of Contents 


DEFINE 


DEFINE: Create a 
VSAM Catalog 


or Cluster 


Diagram EC1 


DEFINE AIX: 
Create an Alternate 
Index 


DEFINE CLUSTER: 
Create a Cluster 


DEFINE PATH: 
Create a Path 


DEFINE NONVSAM: 
Define a NonVSAM 
Data Set 


DEFINE SPACE: 
Initialize a VSAM 


Data Space 


Diagram EG1 


DEFINE CRA: 
Create a Catalog 
Recovery Area 


Catalog 
Management 


Services 
Overview 


Diagram EB1 


Request Determination 


ALTER 


ALTER: Modify a 
Catalog Record 


Diagram EH1 


Flow of control on the same page; 
‘3’ indicates a number of a process 
step on the same page. 


Flow of control between pages; 
‘AA3’ is the diagram number and 
‘2’ is the number of a process step 
on that diagram. 


Pointers 


Reference to data or testing of 
data by a process step; ‘H’ is an 
arbitrary designation. 


Input to process steps and output 
from process steps; ‘A’ is an 
arbitrary designation. 


Modification of data by a process 


step; ‘P’ is an arbitrary designation. 


DEFINE CATALOG: 


DELETE 


DELETE: Remove 
a VSAM or NonVSAM 


Data Set 


Diagram EJ1 


DELETE SPACE: 
Release All Empty 
Data Spaces 


DELETE CATALOG: 
Delete a VSAM 


Catalog 


Diagram EL1 


LISTCAT 


LISTCAT: 


Retrieve a Catalog 
Record’s Contents 


Diagram EI1 


CONVERTV 


CONVERTV: 
Convert a volume 
to or from mass 
storage 


Diagram EM1 


User’s program issues 
SHOWCAT macro 


Return 


SHOWCAT: Display 
fields of a VSAM 
catalog 


Diagram EI2 
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Diagram EB1. Catalog Management Services Overview 


User issues one of the Access 
Method Services commands: 


DEFINE, ALTER, DELETE, 
LISTCAT, or CONVERTV 


1. Check the caller’s authorization to issue the command. 
“7! (See Diagram DD1, ‘“‘Check the Password.”’’) OS/VS System 


2. Did the caller issue a DEFINE command? Catalog 


ae Yes No as: 


tVSAM Master 
Catalog 


Create a VSAM Master Catalog 


YY 


Virtual Storage for the Caller’s Program 


CCA 


tCTGPL 


t Buffer 


VSAM-Owned 
Direct-Acce 
pes Ey Sh a fe te 3. Does the caller want to create the VSAM master vaicte aan 
catalog? a 
tCTGFV No Yes Data Space 


VSAM Master 
Catalog 


VSAM Catalog 


that Owns the 
Direct-Access 
Volume 


4. Build the VSAM master catalog. (See Diagram 22@2222222M 
EC1, ““DEFINE: Create a VSAM Catalog or 


Cluster.’’) CCAPROB 


5. Return to the caller. > 
Create a VSAM Data Space 2 


Data Needed 
to Create a ty 
Catalog or 


Initialize 
a Data Space 


Catalog Management Buffer 


tCatalog’s 
DSNAME 


@ 


Updated 
Volume Record 


that Describes 
» 6. Does the caller want to create a VSAM data space? VSAM-Owned the New VSAM 


Catalog Record 


Password Set of Fields 


Direct-Access Data Space 
Volume 
’ C <n paae> 
. Create a VSAM data space. (See Diagram EG1, SrSZZZZZZZD Initalized 
“DEFINE SPACE: Initialize a VSAM Data Data Space 
Speer CCAPROB 


8. Return to the caller. Zaza) Return Code 


YY YY 
L Cc U 
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Notes for Diagram EB1 


Catalog Management Services is a group of VSAM 
catalog management modules that respond to Access 
Method Services commands. The Catalog Management 
Services Driver routine, IGGPCDVR (IGGOCLAT), calls 
other Catalog Management Services routines as described 
in the table below. 


See ‘“‘Data Areas” for details about the ACB. 


See “‘Diagnostic Aids” for details about catalog 
management return codes and error codes. 


DEFINE CLUSTER, AIX, PATH, 
DEFINE MASTERCATALOG, 
and DEFINE USERCATALOG 


DEFINE CRA 
DEFINE NONVSAM 
DEFINE SPACE 
ALTER 

LISTCAT 


DELETE TYPE (CLUSTER, AIX, PATH) and 
DELETE TYPE (NONVSAM) 


DELETE TYPE (SPACE) 


DELETE TYPE (MASTERCATALOG) and 
DELETE TYPE (USERCATALOG) 


CONVERTV 


IGGOCLAT 
calls: 


IGGOCLAL 
IGGOCLB4 

IGGOCLBH 
IGGOCLAQ 
IGGOCLBD 
IGGOCLBQ 


IGGOCLBG 
IGGOCLBL 


IGGOCLAF 
IGGOCLBZ 


Related Method of 
Operation Diagram: 


Diagram EC1 
Diagram EE3 
Diagram EF1 
Diagram EG1 
Diagram EH1 
Diagram EI1 


Diagram EJ1 
Diagram EK1 


Diagram EL 1 
Diagram EM1 


a1807] (WVSA) Poe Ssed9V eBeIOIg [eNIIA :UsUOdUIOD JUepuadapu] SAS ZTSA/SO 87ZZ 


Diagram EB2. Catalog Management Services Overview 
Create a VSAM User Catalog 


Virtual Storage for the Caller’s Program 9. Does the caller want to create a VSAM user catalog? 
8 
Rt , No Yes 
a“ 
a 10. Search the VSAM master catalog to ensure that 
a | the new user catalog’s DSNAME doesn’t 
CCA 7 duplicate an existing DSNAME. (See Diagram 
“ os DC1, “SEARCH: Retrieve the Base Catalog 
metucR we Record.’’) 
tae mn hy se Ly Te em se 11. Did the search routine set the no-record-found 
error code? 
CTGPL Yes No VSAM Master 
Request v CCAPROB Catalog 
Data Needed 12. Return to the caller. zeae <a aaa 


User-Catalog 
Catalog 


to Createa |}4_______¥#, 13. Build the VSAM user catalog. (See Diagram EC], 


“DEFINE: Create a VSAM Catalog or Cluster.”’) Record 
VSAM-O d 
DSNAME 14. Return to the caller. CCAPROB DireetsAceees 
“> Return Code Volume 


Data Space 


Create a Data Set = 


Identifies \| VSAM User 
ae 15. Search the VSAM catalog specified in the caller’s Catalog 
naan ae CTGFL to ensure that the new data set’s DSNAME 
doesn’t duplicate an existing DSNAME. (See 
Diagram DC1, “SEARCH: Retrieve the Base ine 
\ Catalog Record.’’) bo the New 
\ 16. Did the search routine set the no-record-found VSAM Cluster 
\ error code? 


Yes No 


\ 
\ v CCAPROB VSAM Catalog La te 
17. Return to the caller. peawee> Identified by SRE CT CRESS 
\ the CTGPL oe 
\ @. 18. Process the DEFINE command to create: SHO 
y Caller’s 
\ . @ A cluster (a VSAM data set, with or without Cigsioe Rocata: CTGFV 
\ an index). (See Diagram EC1, ‘“‘DEFINE: Create Describes the ee eee 
NK a VSAM Catalog Cluster, AIX, or Path.”’) New VSAM 5 pom: 
Se ee ce ocate 
@® A nonVSAM data set. (See Diagram EF1, Sue es Noa VSAM 
“DEFINE NONVSAM: Define a NonVSAM NonVSAM Re- Data Set 


cord: Describes 
the New Non- 
VSAM Data 
Set 


Data Set ina VSAM Catalog.’’) 

@ A catalog recovery area. (See Diagram EE3, 
“DEFINE CRA: Create a Catalog Recovery 
Area.”’) CCAPROB 

19. Return to caller. SLL LLL LO 


Y 


Freespace 


c Cc Cc 
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Diagram EB3. Catalog Management Services Overview 


VSAM Catalog 
ey, Process an ALTER, DELETE, LISTCAT, SHOWCAT, or Identified by the 


CONVERTV Request CPL’s Catalog 
DSNAME Value 


Virtual Storage for the Caller’s Program 


Ril 20. Search the VSAM catalog specified in the caller’s 
4 =6s CTGPL and retrieve the catalog record identified Maditisa 
Pe by the caller-supplied DSNAME. (See Diagram Oise 


CCA CTGPL yf DC1, “SEARCH: Retrieve the Base Catalog Record”’ 


tCTGPL Rec uest / 
| tCTGPL —_—_— —~——— 21. Process the command to: 
t Buffer / 


Record 


Free Catalog 


y / @ Modify a catalog record. (See Diagram EH1, 
/ ‘““ALTER: Modify a Catalog Record.’’) VSAM-Owned 
Catalog / @ Delete a cluster, AIX, path, or nonVSAM oo 
Record’s y, data set. (See Diagram EJ1, ““DELETE: <=>. 
DSNAME Remove a VSAM or NonVSAM Data Set.”’) 5599,(G) Sa, eee 


= 
@ Delete all empty data spaces on a volume. Dg 


(See Diagram EK 1, “DELETE SPACE: 
Release All of the Empty VSAM Data 
Spaces on a Volume.’’) 


Freespace 


Catalog’s 
DSNAME 


Identifies the 
Catalog that 

Contains the 
Record to be 
Listed, Altered, 
or Deleted 


@ Delete a VSAM user or master catalog. (See 
Diagram EL1, ““DELETE CATALOG: Release 


a VSAM Catalog.’’) 
’ —PPPPP PLA AL A Lo Catalog Data 
@ Retrieve information from a catalog. (See to Satisfy the 


Diagram EI1, “LISTCAT: Retrieve a Caller’s Request 
Catalog Record’s Contents.’’) 


CTGFVs 


@ Display selected fields of the VSAM catalog. See 
Diagram EI2, “SHOWCAT: Display Fields of a 
VSAM Catalog.’’) 

@® Convert the contents of a direct-access storage 
volume to or from a mass storage volume. (See 
Diagram EM1, “CONVERTV: Convert a Volume 
to or from Mass Storage.’’) CCAPROB 


22. Return to the caller. @eazzerH>)| Return Code 


YY 


Data Needed to 
Alter or Delete 
Catalog 

Information 


Catalog Management Buffer 


Catalog Record to be 
Listed, Altered, or Deleted 
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Diagram EC1. DEFINE: Create a VSAM Catalog, Cluster, AIX or Path 


Virtual Storage for the Caller’s Program 


1. Verify that, if the VSAM master catalog exists, this 
4 request does not attempt to create another one. 


a“ «4 
7” / 2. Verify that each of the caller’s CTGFVs: 


a“ 
7 7 a @ Is within the caller-program’s region, and 
/ 
/ 


@ Contains all the information needed to build the 
/ catalog or VSAM object. Creation Date CTGFV 


CCA 
tCTGPL 
CTGPL 
Request 
Type 
tCTGFV 


3. Deternine the creation date.e'!'_Cun.).9”0..-.QO.N0NON22>202ENn—D 


4. Did the caller issue a DEFINE catalog request? 


No Yes 


4 Newly-Created 
VSAM Catalog 


See the Data 
Areas Section 
for a List of 


ae 5. Build the VSAM catalog. (See Diagram EE], 
Create a VSAM “DEFINE CATALOG: Create a VSAM Catalog.’’) 
Object or 


CCAPROB 


6. Return to the caller. Rearrwrwre Return Code 


7. Did the caller issue a DEFINE PATH 

request? 

No Yes 
q Newly -Created 
VSAM Path 
PO) 8. Build the VSAM path (See 
Diagram EDS “DEFINE PATH: 

Create a Path.’’) CCAPROB 

9. Return to calle eae 


10. Did the caller issue a DEFINE ALX 
request? 
No Yes 


Catalog 


OS/VS Nucleus 


VSAM-Master- 
Catalog-Open 
Flag is ON 


| 


Newly Created 
VSAM AIX 


11. Build the VSAM AIX (See Diagram 
ED2: “DEFINE AIX: Create an Alternate 


bey CCAPROB 
12. Return to caller paxprerr > 


13. Build the VSAM cluster (See Diagram EDI. 
DEFINE CLUSTER: “Create a Cluster.”’) 


Newly-Created 
CCAPROB VSAM Cluster 


14. Return to caller pyxeepeeeePX> Return Code 


! 
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Notes for Diagram EC1 


When the user issues the Access Method Services 


DEFINE command to create a catalog (either user or 


master) or a VSAM object, the catalog management 


C 


3 IGGOCLAL: IGGPDEDE 


IGGOCLAN: IGGPDSCB (calls IGGPDCDA 
(IGGOCLAP) and IGGPDEFC (IGGOCLAS)) 


IGGOCLAL: IGGPDDEP 


services DEFINE: Initial Processing modules ensure that 


the caller provided all the information necessary to create 


a catalog or VSAM object. 
1 IGGOCLAL: IGGPDEF 
2 IGGOCLAL: IGGPDEDE 


CTGFVs are checked by routines (internal 
procedures) in the IGGOCLAL and IGGOCLAN 
modules, as shown in the table below. 


CTGFV 

Cluster CTGFV 

AIX CTGFV 

Caller’s work area 

Data CTGFV structure 
Index CTGFYV structure 
Data dsname CTGFV 
Index dsname CTGFV 
Path CTGFV 

Data space CTGFV 
Catalog’s space CTGFV 
Key range CTGFV 

Space parameter CTGFLs 
Buffer size CTGFLs 
Average record size CTGFLs 


10 IGGOCLAL: IGGPDCWC 


13 IGGOCLAN: IGGPDSCB (calls IGGPDRDA 
(IGGOCLAN) and IGGPDBDI (IGGOCLAJ)) 


Module Procedure 
IGGOCLAL: IGGPDCWC 
IGGOCLAL: IGGPDCWC 
IGGOCLAL: IGGPDCWC 
IGGOCLAL: IGGPDFSC 
IGGOCLAL: IGGPDFSC 
IGGOCLAL: IGGPDDNP 
IGGOCLAL: IGGPDDNP 
IGGOCLAL: IGGPDDEP 
IGGOCLAL: IGGPDBVC 
IGGOCLAL: IGGPDCSF 
IGGOCLAL: IGGPDRPG 
IGGOCLAN: IGGPDSPF 
IGGOCLAN: IGGPDBSF 
IGGOCLAN: IGGPDALR 
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Diagram ED1. DEFINE CLUSTER: Create a Cluster 


1. Build the cluster’s AMDSB set of fields. 
2. Compute the amount of direct-access space required 


Virtual Storage for the Caller’s Program ) for the cluster. 


R11 (B) 3. Obtain contiguous free catalog records from the catalog 
CTGFLs 4 a specified in the caller’s CPL and assign them to the cluster. 
Describes Data / 


Set and Index 
/ 
On 


uild the cluster catalog record 


Characteristics 


4. Initialize the cluster catalog record’s header fields. 


D 


CCA 
+CTGPL 
tCatalog’s 

ACB 


5. Build an association set of fields to point to the data 
set catalog record and, if the cluster is key-sequenced, 
the index catalog record. 


Describes Data 
Set and Index 
Space 

Requirements 


. Build the cluster’s password set of fields. 


a 


7. Compute the cluster catalog record’s size. 


. Write the cluster catalog record into the catalog. 


Do steps 9 through 23 to: 


@ Build the data set catalog record to describe the data 
G set and its assigned space. 


~ @ Build the index catalog record to describe the data 
(es set’s index and its assigned space, if the cluster is 
key-sequenced. 


9. Initialize the catalog record’s header fields. 


Obtain direct-access space.to satisfy the data set’s or 
index’s space allocation requirements 


Describes Data 
Set and Index 
Volume Usage 
and Serial 
Numbers 


(Cy—> 10. Can the data set or index share its space with other 
VSAM data sets and indexes? 


No 


v 


11. Allocate a VSAM data space to the data set or 
| index. (See Diagram EG1, ‘‘DEFINE SPACE: 


Yes 


Catalog Management Buffers 


a“ 
Free Catalog Record #1 yO 


a“ 
Free Catalog Record #2 

“ 
Free Catalog Record #3 


Initialize a VSAM Data Space.’’) 


12. Allocate space to the data set or index from an 
existing VSAM data space. (See Diagram DJ1, 
“SUBALLOCATE: Obtain Additional Space from 
a Nonunique VSAM Data Space.’’) 


YY 
L c 


a 


Catalog Management 
Work Area 


AMDSB Set-of- Fields 


Amount of Space 
Needed for the Cluster 


Catalog Management Buffers 


Cluster Catalog Record 


Data Set Catalog Record 


Index Catalog Record 


VSAM Catalog 
Identified by the 
Caller’s CTGPL 


New Cluster 
Catalog Record 


VSAM-Owned 
Direct-Access 
Volume 


Space Allocated 
to the Data Set 
or Index 
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Notes for Diagram ED1 


This figure describes the processes performed by catalog 
management services routines when the user issues the 
Access Method Services DEFINE CLUSTER command 
in the form: 


DEFINE 

CLUSTER 

| CATALOG (catname/password) | 
(parameterlist) 


where: 


¢ catname is the name of the catalog that will contain 
the cluster, data, and index catalog records that 
describe the user’s data set. 


¢ password is the catalog’s master, control interval, or 
update password, if the catalog is protected by 
passwords. 


e parameteriist is a list of optional and required 
parameters that define the cluster’s characteristics. 


See OS/VS2 SVS Independent Component: Access 


Method Services for details about the DEFINE command 


parameters. 
1 IGGOCLAN: IGGPDRDA 


The AMDSB contains the cluster’s statistics and fixed 


characteristics. Each time the cluster is opened, the 
AMDSSB is retrieved from the data catalog record. 


When the cluster is closed, the AMDSB is updated and 


rewritten into the data catalog record. 
See ‘“‘Data Areas” for details about the AMDSB. 


2 IGGOCLAN: IGGPDSPC 


The field vector table contains addresses of buffer-size 


and record-length field parameter lists (CTGFLs). 
This data is used to determine the data set’s 


control-interval and control-area size. If the data set is 


key-sequenced, ~ther buffer-size and record-length 
CTGFLs determin .... index’s control-interval and 
control-area size. If the key-sequenced data set is 
divided into key ranges, the size of each key range is 
determined. 


3 IGGOCLAN: IGGPDCCE 


A user’s data set is described by a cluster catalog 
record, a data catalog record, and, if the data set is 
key-sequenced, an index catalog record. 


See ‘Data Areas” for details about the catalog record. 


C 


8 IGGOCLAN: IGGPDCCE 


The DEFINE routine issues an ADDREC macro 
instruction to write the cluster record into the catalog. 


9 IGGOCLAJ: IGGPDBDI 


See ‘‘Data Areas” for details about the data catalog 
record. 


10 IGGOCLAJ: IGGPDSPO 


11 IGGOCLAJ: IGGPDSPO (calls IGGPDEFS 
(IGGOCLAQ)) 


A data space group set of fields is added to the volume 
catalog record, and the data set’s name is added to the 
volume catalog record’s data set directory. 


See ‘‘Data Areas” for details about the volume catalog 
record, the data space group set of fields, and its data 
set directory entry set of fields. 


12 IGGOCLAJ: IGGPDSPO (calls IGGPSALL 
(IGGOCLAR)) 


The data set’s name is added to the volume catalog 
record’s data set directory e1..1ry set of fields, and the 
volume catalog record’s data space group set of fields 
is updated to show the cylinders and tracks allocated 
to the new data set or index. 
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Diagram ED2. DEFINE CLUSTER: Create a Cluster 


Virtual Storage for the Caller’s Program Assign space (continued) Virtual Storage for the Caller’s Program 


13. Build an extent descriptor that describes each extent 
allocated to the data set or index. 


Work Area 


Work Area 


Low and High CCHH 
Values for Each Extent 
Allocated to the Data 
Set, Index, or Data 
Set’s Key Range 


4. If the data set is divided into key ranges, assign space 
to each of the data set’s key ranges. 


CCA 
tWork Area 
t Buffers 
tCTGPL 


tWork Area 
t Buffers 


. Assign candidate volumes to the data set or index. 
(See Diagram DJ1, “SUBALLOCATE” -— Assign a 
Candidate Volume to the Object.) 


Build a volume information set of fields to describe: 


Extent 
Descriptors 
(From Steps 13 & 14) 


Volume Information 
Sets of Fields 

(From Steps 16, 17, 
and 18) 


. All extents allocated to the data set or index on each 
volume. 


17. All extents allocated to each of the data set’s key 
ranges on each volume. 


18. Each of the data set’s or index’s candidate 
volumes. 


Describes Data Set 
and Index Volume 19. Is the ‘“‘sequence set with data” option specified? 
Usage and Serial vy No Yes 

Numbers 


Catalog Management Buffers 


20. Assign part of each of the data set’s extents 
to the sequence set. 


sob he i VSAM C 
tCTGFLs "|_-9f Describes Data Set 21. Put each volume information set of fields into the data eee 


and Index set or index catalog record. (See Diagram DMI, Caller’s CTGPL 
Characteristics “Modify a Catalog Record Field’s Value.”’) 
22. Write the data set or index catalog record into the 
Ys catalog. New Data Set 
,\ Catalog Record 
23. Free the virtual storage of the work areas obtained by 
the Define routine. New Index 
Write SMF record type 63 Catalog Record 
24. Does the OS/VS system include the system 
Catalog Management Buffers management facility (SMF)? 


N 
Data Set Catalog Record o 86 Yes 
Index Catalog Record 


SMF Data Set 


—————e 25. Write SMF record type 63 — Cluster Cataloged. 


Record Type 63 


CCAPROB 


26. Return to the caller. waa 


L Cc UC 
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Notes for Diagram ED2 


13 IGGOCLAJ: IGGPDSEX 
15 IGGOCLAJ: IGGPDCNV 


A candidate volume is available to contain part of the 
cluster if more space is needed later. None of the 
candidate volume’s space is allocated to the data set or 
index when the cluster is created. 


16 IGGOCLAK: IGGPDBVO 


Each volume that contains a part of the data set or 
index is described by a volume information set of 
fields within the data set or index catalog record. 


See ‘‘Data Areas” for details about the data catalog 
record, the index catalog record, and the volume 
information set of fields. 


17 IGGOCLAK: IGGPDRNG 


If the data set is divided into key ranges, each key 
range’s space on a volume is described in a separate 
volume information set of fields. If the key range’s 
space is on more than one volume, each volume that 
contains part of the key range’s space is described is a 
separate volume information set of fields. 


18 IGGOCLAK: IGGPDBCV 
20 IGGOCLAK: IGGPDSSP 


If the ‘‘sequence set with data” option is specified, part 
of the data set’s space is allocated to the index for 
sequence set records. The low and high CCHH values 
in the index record’s volume information set of fields 
are those of the extent obtained for the data set. The 
low and high RBA values are for the sequence set and 
are relative to the index addresses. 


21 IGGOCLAK: IGGPDMOP 
22 IGGOCLAK: IGGPDMOP 


A catalog management routine writes the completed 
data set or index catalog record into the VSAM 
catalog and frees the catalog management buffer that 
contains the record. 


23 IGGOCLAS8: IGGPDFRS 


25 IGGOCLAJ: IGGPDBDI (calls IGGPSMFA 
(IGGOCLBYV)) 


See OS/VS System Management Facilities (SMF) for 
details of SMF record type 63—-VSAM Data Set 
Cataloged. Record type 63 is written after a VSAM 
cluster or catalog is defined and whenever the 
definition is altered. 


C 


26 See “Diagnostic Aids” for details about catalog 
management return codes and error codes. 


d1807] (WIVSA) PoureW] ssad0y a8eI0I1g [eNIIA :JUsUOdUIOD Jopuadapu] SAS ZSA/SO 9EZ 


Diagram ED3. DEFINE AIX: Create an Alternate Index 
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Catalog Management Buffers 


Free Catalog Record #1 
Free Catalog Record #2 
Free Catalog Record #3 


12. 


c 


. Get base cluster record, verify password, and build 


. Compute the amount of direct-access space required 
for the AIX. i eee 


. Obtain contiguous free catalog records from the 


to the AIX, and build an association set of fields in 
the cluster record. 
ild the AIX catalog record 


. Initialize the AIX catalog record’s header fields. 


. Build an association set of fields to point to the jst —_ 


6. Build the AIX’s password set of fields. 
7. Compute the AIX catalog record’s size. 


8. Write the AIX catalog record into the catalog. 


Do steps 9 through 23 to: 


. Initialize the catalog record’s header fields. >G) 


Obtain direct-access space to satisfy the data set’s or 
index’s space allocation requirements 


Catalog Management 


Work Area 
AMDSSB Set-of- Fields 


the-AIX’s AMDSB set of fields. 


Amount of Space 
Needed for the Cluster 


catalog specified in the caller’s CTGPI, assign them 


Catalog Management Buffers 


set catalog record, the index catalog record, and the 


related cluster catalog record. 


OS/VS2 Catalog 
Identified by the 
Caller’s CTGPL 


Build the data set catalog record to describe the data 
set and its assigned space. 

Build the index catalog record to describe the data 
set’s index and its.assigned space. 


New AIX 
Catalog Record 


Can the data set or index share its space with other 
VSAM data sets and indexes? 

No VSAM-Owned 
Direct-Access 
11. Allocate a VSAM data space to the data set Volume 
or index. (See Diagram EG1, ‘SDEFINE 


SPACE: Initialize a VSAM Data Space.’’) 


Allocate space to the data set or index from an 
existing VSAM data space. (See Diagram DJ1, 

“Suballocate: Obtain Additional Space from a 
Nonunique VSAM Data Space.’’) 


Space Allocated 


to the Data Set 
or Index 
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Notes for Diagram ED3 


This figure describes the processes performed by catalog 
management services routines when the user issues the 
Access Method Services DEFINE AIX command in the 
form: 


DEFINE 

AIX 

(parameterlist) 
[CATALOG(catname/ password)] 


where: 


e catname is the name of the catalog that will contain 
the AIX, data set, and index catalog records that 
describe the user’s data set. 


* password is the catalog’s master, control interval, or 
update password, if the catalog is protected by 
passwords. 


* parameterilist is a list of optional and required 
parameters that define the AIX’s chacteristics. 


See OS/VS2 SVS Independent Component: Access 
Method Services for details about the DEFINE command 
parameters. 


1 IGGOCLAN: IGGPDRDA 


The AMDSSB contains the cluster’s statistics and fixed 
characteristics. The AMDSB set of fields is in the Data 
catalog record (for an entry-sequenced data set) and in 
the Data and Index catalog records (for a 
key-sequenced data set). Each time the cluster is 
opened, the AMDSB is retrieved from the data set 
catalog record. When the cluster is closed, the 
AMDSSB is updated and rewritten into the data set 
catalog record. 


2 IGGOCLAN: IGGPDSPC 


The field vector table (CTGFV) contains addresses of 
buffer-size and record-length field parameter lists 
(CTGFLs). This data is used to determine the data 
set’s control-interval and control-area size. If the data 
set is key-sequenced, other buffer-size and 
record-length CTGFLs determine the index’s 
control-interval and control-area size. If the 
key-sequenced data set is divided into key ranges, the 
size of each key range is determined. 


IGGOCLBX 


IGGOCLBX determines the amount of secondary 
storage needed. For Pagespaces, IGGOCLBX 
calculates this space using track overflow where 
appropriate. 


C 


IGGOCLBY: IGGPDRSP 


IGGPDRSP is called to calculate the space 
parameters. 


3 IGGOCLAG: IGGPAOCI 
IGGOCLBS: IGGPMODC 


IGGPAOCTI is called to obtain three contiguous 
catalog control intervals to contain the AIX, data set, 
and index catalog records. 


8 IGGOCLAN: IGGPDCCE 


The DEFINE routine issues an ADDREC macro 
instruction to write the AIX record into the catalog. 


9 IGGOCLAJ: IGGPDBDI 
10 IGGOCLAJ: IGGPDSPO 


11 IGGOCLAJ: IGGPDSPO (calls IGGPDEFS 
(IGGOCLAQ)) 


A Data Space Group set of fields is added to the 
volume catalog record, and the data set’s name is 
added to the volume catalog record’s data set 
directory. 


12 IGGOCLAJ: IGGPDSPO (calls IGGPSALL 
(IGGOCLAR)) 


The data set’s name is added to the volume catalog 
record’s Data Set Directory Entry set of fields, and the 
volume catalog record’s Data Space Group set of 
fields is updated to show the cylinders and tracks 
allocated to the new data set or index. 


For additional information about topics related to 
DEFINE AIX processing, see: 


“Data Areas.”’ 


Catalog record description and format 

Data set catalog record description and format 
Volume catalog record description and format 
Data set group set of fields description 

Data set directory entry set of fields descrption 
Access Method data set statistics block (AMDSB) 
description and format 


SIdOT (WVSA) POY SS999y B3eIOIS JENA :JUaUOdUIOD jUspuadapu] SAS ZSA/SO SEZ 


Diagram ED4. DEFINE AIX: Create an Alternate Index 


‘Virtual Storage for the Caller’s Program Assign Space (continued) Virtual Storage for the Caller’s Program 
E> ¢ . Build an extent descriptor that describes each 
extent allocated to the data set or index. =F 
14. If the data set is divided into key ranges, sign 
space to each of the data set’s key ranges. 
a6 | 
15. Assign candidate volumes to the data set or 
index. (See Diagram DJ! , “Suballocate: 
Assign a Cundidate Volume to the Object.’’) 
AN Build a Volume Information Set of Fields to Describe: 


Work Area 


Low and High CCHH 
Values for Each Extent 
Allocated to the Data 
Set, Index, of Data 
Set’s Key Runge 


tWork Area 
t Buffers 


1CTGPL 
tCTGFV 


Extent 
Descriptors 
(from steps 13 & 14) 


16. All extents allocated to the data set or index on 


Volume Information 
Sets of Fields 

(from steps 16, 17, 
and 18) 


each volume. (ii) 
17. All extents allocated to each of the data set’s —— 


key ranges on each volume. 
18. Each of the data set’s or index’s candidate (47 (H) 
volumes. 


Describes Data Set 
and Index Volume 
Usage and Serial 

Numbers 


19, Is the “sequence set with data” option specified? 


A No Yes Catalog Management Buffers 


Updated Data Set Catalog Record 


Updated Index Catalog Record 


=> 20. Assign part of each of the data set's 
extents to the sequence set. 


21. Put each volume information set of fields into 


OS/VS2 Catalog 


'CTGFLs j Describes Data Set the data set or index catalog record. (See Identified by the 
and Index Diagram DM1, ‘‘Modify the Catalog Record.”’) Caller’s CTGPL 


23. Free the virtual storage of the work areas 


obtained by the DEFINE routine. 
Write SMF Record Type 63 a. 
24. Does the OS/VS system include the system 


management facility (SMF)? 
Yes 


22. Write the data set or index catalog record into Cie 
dies ee Ea 


Catalog Management Buffers 


Duta Set Catalog Record 
Index Catalog Record 


No SMF Duta Set 


z Cataloged, 


CCAPROB 


26. Return to the caller. 
= 


c c c 
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Notes for Diagram ED4 
13 IGGOCLAJ: IGGPDSEX 
14 IGGOCLAJ: IGGPDSPO 


Each key range is assigend physical space and space 
allocation continues until all key ranges have been 
assigned space. 


15 IGGOCLBO: IGGPDCNV 


A candidate volume is available to contain part of the 
cluster if more space is needed later. None of the 
candidate volume’s space is allocated to the data set or 
index when the AIX is created. 


16 IGGOCLAK: IGGPDBVO 


Each volume that contains a part of the data set or 
index is described by a volume information set of 
fields within the data set or index catalog record. 


17 IGGOCLAK: IGGPDRNG 


If the data set is divided into key ranges, each key 
range’s space on a volume is described in a separate 
volume information set of fields. If the key range’s 
space is on more than one volume, each volume that 
contains part of the key range’s space is described in a 
separate volume information set of fields. 


18 IGGOCLAK: IGGPDBCV 


IGGPDBCYV builds a volume information set of fields 
for each candidate volume of the data set. 


20 IGGOCLAK: IGGPDSSP 


If the ‘sequence set with data”’ option is specified, 
part of the data set’s space is allocated to the index for 
sequence set records. The low and high CCHH values 
in the index record’s volume information set of fields 
are those of the extent obtained for the data set. The 
low and high RBA values are for the sequence set and 
are relatie to the index addresses. 


21 IGGOCLAK: IGGPDMOP 


IGGPDMOP calls IGGPMOD to add each volume 
information set of fields to the record. 


22 IGGOCLAK: IGGPDMOP 


A catalog management routine writes the completed 
data set or index catalog record into the VSAM 
catalog and frees the catalog management buffer that 
contains the record. 


23 IGGOCLAS: IGGPDFRS 
IGGPDFRS frees all unneeded storage resources. 


C 


25 IGGOCLAJ: IGGPDBDI (calls IGGPSMFA 
(IGGOCLBV)) 


See OS/VS System Management Facilities (SMF) for 
details of SMF record type 63—-VSAM Data Set 
Cataloged. Record type 63 is written after a VSAM 
AIX is defined and whenever the definition is altered. 


26 For additional information about topics related to 
DEFINE AIX processing, see: 


‘“‘Data Areas.” 


Data set catalog record description and format 
Index catalog record description and format 
Volume information set of fields description 


‘Diagnostic Aids.”’ 


Catalog management return codes 
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Diagram ED5. DEFINE PATH: Create a Path 


NY 


1. Get base cluster or AIX record and verify master 


CTGFL password. 


/RGATTR [> (A) 2. Obtain Free catalog record from the catalog 
a-7 specified in the CTGPL and assign it to the path. 


Virtual Storage for Caller’s Program 


Catalog Management Buffers 


Path Catalog Record 
Updated Cluster or AIX Record 


Catalog Identified 
by CTGPL 


Build the Path Record 


3. Initialize the path record header 
fields. 


. Build the association sets of fields. 


. Write the path record into the catalog. 


New Path 
Catalog 
Record 


CTGPL 


6. Write SMF record type 63. CCAPROB 


7. Return to the caller. RSSSSSSSDS 


TCTGFV 


CTGFV 
SMF Data Set 


Record 
Type 63 
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Notes for Diagram EDS 


This figure describes the processes performed by the 
catalog management services routines when the user 
issues the Access Method Services DEFINE PATH 
command in the form: 


DEFINE PATH (NAME(name) 
PATHENTRY (entryname/ password) 
(parameterlist)) 


where: 


name specifies the name to be given to the alternate 
index/base cluster pair (i.e., the path). 


entryname specifies the name of the alternate index or 
cluster which is to be considered as the entry to the 
path. 


password specifies the master-level password. 


parameterlist is a list of optional and required 
parameters that define the path’s characteristics. 


See OS/VS2 SVS Independent Component: Access 
Method Services for details about the DEFINE command. 


1 
2 


IGGOCLB9: IGGPPRPW 
IGGOCLAG: IGGPAOCI 


IGGPAOCI is called to obtain one catalog control 
interval to contain the path record. 


IGGOCLB9: IGGPBAWP 
IGGOCLB9: IGGPBAWP and IGGPBAMC 


Builds an association set of fields to point to the 
cluster and index records and, if the cluster is 
key-sequenced, the index record. If the path is being 
built over the AIX, then the pointers to the AIX, the 
AIX data, and the AIX index records are also 
included. An association set of fields is also built in the 
cluster or AIX record to point to the path record. 


IGGOCLB9: IGGPBAWP 


The DEFINE routine issues a modify with a put/add 
option to insert all the association sets of fields into 
the path record and to write the record into the 
catalog. These association sets of fields had been 
extracted previously from the cluster and the AIX 
records, if the path‘is being built over an AIX. 


IGGOCLBV: IGGPSMFA 


Record type 63 is written after a VSAM path is 
defined. 
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Diagram EE1. DEFINE CATALOG: Create a VSAM Catalog 
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Create a Catalog Recovery Area.” 


Catalog’s| Records 


Catalog Management Buffers e/a to Describe VSAM| Index 
| = 3 , e = 
User-Cutalog Catalog Record 13. oe of the catalog’s space to each part of mez Describing dusters, Nolaies, 
ci#0— | Catal 2 Records Bata Set 
atalog’s 
Through -+ Self-Describin . . : : , 
cls” Ciaige Records 14. Build a volume information set of fields to describe 


Qn, each part’s assigned space (from step 13). 
Cl#2 Catalog’s Cluster ; 
Catalog Record 15. Build the catalog records that describe the catalog as a 
key-sequenced data set with two Key ranges. 
CI#10 Space Map Set of Fields 
-13 for the Volume 


<8 


€vZ UoNeIsdO jo pops 


Cr 


Notes for Diagram EE1 


This figure describes the processes performed by the 
catalog management services routines when the user 
issues the Access Method Services DEFINE 
MASTERCATALOG or DEFINE USERCATALOG 
command in the form: 


DEFINE MASTERCATALOG 
or 


DEFINE USERCATALOG 
[CATALOG (catname/password)] 
(parameterlist) 


where: 


catname is the name of the VSAM master catalog, 
which will contain the catalog record that describes 
the VSAM user catalog. 


password is the VSAM master catalog’s master, 
control interval, or update password, if the master 
catalog is protected by passwords. 


parameterlist fields are described in OS/VS2 SVS 
Independent Component: Access Method Services. 


IGGOCLAP: IGGPDCDA 


The AMDSB contains the catalog’s statistics and fixed 
characteristics. Each time the catalog is opened, the 
AMDSSB is retrieved from the catalog’s data set 
catalog record (control interval number 0). When the 
catalog is closed, the AMDSB is updated and rewritten 
into the data set catalog record. 


See “‘Data Areas” for details about the AMDSB. 
IGGOCLAP: IGGPDCSP 


The field vector table contains addresses of buffer-size 
and record-length CTGFLs. This data is used to 
determine the catalog’s control-interval and 
control-area size, and the amount of space required 
for the catalog. 


IGGOCLAP: IGGPDCPC 


The OS/VS system catalog contains a data set entry 
that describes the VSAM master catalog as a private 
catalog to the OS/VS system catalog. 


IGGOCLAP: IGGPDCPC 


See ‘‘Data Areas” for details about the user-catalog 
catalog record. 


7 


C 


IGGOCLAN: IGGPDCCE 


The cluster catalog record contains an 
associated-data-set set of fields to locate the catalog’s 
data set catalog record (control interval number 0) and 
an associated-index set of fields to locate the catalog’s 
index catalog record (control interval number 1). 


See ‘‘Data Areas” for details about the cluster catalog 
record. 


10 IGGOCLAS: IGGPDCSP (calls IGGPDEFS 


11 


(IGGOCLAQ)) 


The VSAM catalog is always built in a data space that 
can contain other VSAM data sets and indexes. A new 
data space is allocated to VSAM by the OS/VS 
DADSM Allocate routine, and the data space is 
assigned to the new catalog. 


See “Data Areas” for details about the volume catalog 
record, the data space group set of fields, and the data 
set directory entry set of fields. 


IGGOCLAS: IGGPDCSP (calls IGGPSALL 
(IGGOCLAR)) 


A data set directory entry set of fields containing the 
cluster’s control interval number is added to the 
volume catalog record. 


12 IGGOCLAS: IGGPDCSP (calls IGGPDCRA 


(IGGOCLB4)) 


13 IGGOCLAS: IGGPDCLD 


The catalog might contain records that describe user’s 
VSAM data sets, user’s nonVSAM data sets, 
direct-access volumes, and (in the VSAM master 
catalog) VSAM user catalogs. 


See ‘“Data Areas” for details about the catalog record. 


14 IGGOCLAS: IGGPDCVO 
15 IGGOCLAS: IGGPDCBE 


See “Data Areas” for details about the first 
preformatted records in the catalog. These records 
define the catalog as a key-sequenced VSAM data set, 
describe the space allocated to the catalog’s data 
records, index records, and true name records, 
describe the free space control intervals within the 
catalog’s data space, and describe the allocated and 
unallocated tracks on a catalog’s volume. 
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Diagram EE2. DEFINE CATALOG: Create a VSAM Catalog 


Virtual Storage for the Caller’s Program 


ACB (From 
Step 16) 


Describes 
the Catalog 


RPL (From 
Step 16) ¥ 


Describes the 
PUT Request 
tTACB 

+ Buffer 


CCA 


t Buffers 


butters 


Request 
Type 


Catalog Management Buffers 


Catalog’s Self-Describing 
Catalog Records 
True-Name Records 


~— 


/ 


Ny 


7 
7 
~W- 
pa ee 
a 
a” 


Open the Catalog 


4 18. 
7 step 15) into the catalog. 
Sey Build and write true-name catalog records for the 
“t,1 


“~ * 20. Close the catalog’s ACB. (See Diagram AD1, ‘‘VSAM 


Virtual Storage for the Caller’s Program 
Ril 


. Build the control blocks to allow the catalog to be 
opened and processed as a VSAM data set. 


CCA 


fT Alt. TIOT 


TCAXWA 


TACB 


. Open the catalog’s ACB to allow catalog records to 
be written: (See Diagram AC1, ‘““VSAM OPEN: 
Connect a User to a VSAM Data Set.’’) 


Alternate 


pd TIOT 


toa 
ACB 


Opened VSAM Catalog 


Write the catalog’s self-describing records (built in 


catalog DSNAME and the data space’s volume 
serial number. 


CLOSE: Disconnect a User from a VSAM Data Set.’’) 
21. Delete the control blocks built in step 16. 


Catalog’s Self-Describing 
Catalog Records 


True-Name Records 


OS/VS System Queue Area 


Open the VSAM Master Catalog 
>22. Did the request create the VSAM master catalog? 


23. Build the control blocks required to open the 
VSAM master catalog. 

24. Open the VSAM master catalog. (See Diagram 

ACI, ““VSAM OPEN: Connect a User to a 

VSAM Data Set.’’) 


Write SMF record type 63 


25. Does the OS/VS system include the system 
management facilities (SMF)? 


Opened VSAM 
Master Catalog 
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26. Write SMF record type 63 — Cluster Cataloged. SMF Data Set 
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27. Return to the caller. 
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Notes for Diagram EE2 


16 IGGOCLAE: IGGPDCCB 


See ‘‘Data Areas” for details about the ACB and 
CAXWA. 


17 IGGOCLAE: IGGPDCCB 


The ACB describes the catalog as a VSAM data set to 
VSAM record management routines. 


18 IGGOCLAE: IGGPDCPR 
19 IGGOCLAE: IGGPDCPR 


See ‘‘Data Areas” for details about the true name 
catalog record. 


23 IGGOCLAE: IGGPDCME (calls IGGPMCO2 
(IGGOCLAD)) 


24 IGGOCLAD: IGGPMCO2 
26 IGGOCLBV: IGGPSMFA 


See OS/VS System Management Facilities (SMF) for 
the format of SMF record type 63—VSAM Data Set 
Cataloged. Record type 63 is written after a VSAM 
catalog is defined for the cluster, data, and index 
components and whenever the catalog’s definition is 
altered. definition is altered. 


27 


The catalog management services DEFINE routine 
sets a return code in the CCA’s CCAPROB field and 
returns to the caller whenever an error is detected. 


See ‘‘Diagnostic Aids” for details about catalog 
management return codes. 


IC 
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Diagram EE3. DEFINE CRA: Create a Catalog Recovery Area 
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Notes for Diagram EE3 


1 
2 
3 


9 


IGGOCLB4: IGGPSTRG 
IGGOCLB4: IGGPSTRG 
IGGOCLB4: IGGPRDEF 


If the caller is DEFINE SPACE and the request is for 
a unique data space or for a candidate volume, 
IGGPRDEF will construct an interface to recursively 
call DEFINE SPACE (IGGPDEFS) to obtain one 
cylinder of space for the CRA. 


IGGOCLB4: IGGPSBAL 


Suballocate one cylinder for the CRA from the data 
space. 


IGGOCLB4: IGGPFMT4 
IGGOCLB4: IGGPF4RD, IGGPF4WR 


IGGOCLB4: IGGPCHIU 


IGGOCLB4: IGGPCCIO, IGGPCI15 
IGGOCLDA: IGGPMODI 


The CRA self-describing records are constructed in 
main storage; the MODIFY function 1s called via 
IGGPMODI to complete the record construction. 


IGGOCLB4: IGGPCACB, IGGPCXWA 


An ACB and a CAXWA are built in a catalog 
management buffer for use by OPEN. 


IGGOCLB4: IGGPOCRA 


10 IGGOCLDA: IGGPWCRA 


The CRA self-describing records are written to the 
volume. The volume base and extension records are 
also written to the CRA. For a DEFINE CATALOG 
caller, the records are pointed to by an address array 
in the CMS workarea; for the DEFINE SPACE caller, 
the volume records are chained from a pointer in the 
CCA. 


12 IGGOCLDA: IGGPWCAT 


The chained volume records are also written into the 
catalog if DEFINE SPACE is the caller. 


SIdOT (WIVSA) POYsl SSdd9y a8BIOIS [eNpITA :JUsUOdWOD Uapusdapu] SAS ZS/./SO 8bZ 


Virtual Storage for the Caller’s Program ane 
Ril 


Diagram EF 1. DEFINE NONVSAM: Define a NonVSAM 
Data Set in a VSAM Catalog 
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the catalog. 
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nonVSAM catalog record can be located by the 


CTGFV 
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Notes for Diagram EF1 


This figure describes the processes performed by the 
catalog management services routines when the user 
issues the Access Method Services DEFINE NONVSAM 
command in the form: 


DEFINE 
NONVSAM (parameterlist) 
[CATALOG (catname/password)] 


where: 


catname is the name of the catalog that will contain 
the nonVSAM catalog record that describes the user’s 
nonVSAM data set. 


password is the catalog’s master or update password, if 
the catalog is protected by passwords. 


parameterlist fields are described in OS/VS2 SVS 
Independent Component: Access Method Services. 


See “‘Data Areas” for details about the nonVSAM 
catalog record. 


IGGOCLBH: IGGPDEFA, IGGPDAIN and IGGPDAVO 


The DEFINE NONVSAM routine builds and transfers 
the nonVSAM catalog record from a catalog 
management buffer in virtual storage to the VSAM 
catalog specified by the caller’s DEFINE command. 


If the nonVSAM data set is being defined in a 
recoverable catalog, the catalog’s volume serial 
number and device type are saved in the nonVSAM 
catalog record. 


IGGOCLBH: IGGPDEFA 


See ‘‘Data Areas” for details about the true name 
catalog record. 


IGGOCLBH: IGGPDEFA 


See “Data Areas” for details about the catalog index 
record. 


See “Diagnostic Aids” for details about catalog 
management return codes. 


Note: This figure also describes the processes 
performed when the user issues an IMPORT 
command to connect a VSAM user catalog (created on 
another OS/VS system and defined in that system’s 
VSAM master catalog) to the VSAM master catalog. 
This process is similar to defining a nonVSAM data 
set, and should not be confused with the process 


C 


described in Diagram EE1, DEFINE CATALOG: 
Create A VSAM Catalog. 


The VSAM user catalog record is similar to the 
nonVSAM catalog record, except the record’s ID 
(identifier) value is ““U” and there is one volume 
information set of fields to describe the volume 
containing the user catalog. 


130 (WVSA) POY} ssoddy 3eI0}S [eNIA :JUIUOdUIOD JUSpUsdepuUT SAS ZSA/SO OSTZ 


Diagram EGI. DEFINE SPACE: Initialize a VSAM Data Space 
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Volume 
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7. Allocate space from the volume’s free space for the 
VSAM data space. (See OS/VSI1 DADSM Logic, 
‘‘NonISAM Data Set Allocation.’’) 
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Notes for Diagram EG1 


This diagram describes the processes performed by the 
catalog management services routines when the user 
issues the Access Method Services DEFINE SPACE 
command in the form: 


DEFINE SPACE 
[CATALOG (catname/password)] 
parameterlist 


where: 


¢ catname is the name of the catalog that contains the 
volume catalog record that will describe the VSAM 
data space. 


¢ password is the catalog’s master, control interval, or 
update password, if the catalog is protected by 
passwords. 


¢ parameterlist fields are described in OS/VS2 SVS 
Independent Component: Access Method Services. 


1 IGGOCLAQ: IGGPDEFS and IGGPVMTV 
2 IGGOCLA6: IGGPCRTC 


The user can specify the data space’s cylinder and 
track requirements, or he can specify a number of 
records and the length of each record, to define the 
data space’s allocation requirements. 


3 IGGOCLAQ 


If a volume catalog record exists for the volume, and if 


the volume already contains a VSAM data space, a 


Data Space Group set of fields is added to the volume 
catalog record to describe the new VSAM data space. 


A new format-1 (identifier) DSCB is added to the 
volume’s VTOC to describe the new extent. 


4 IGGOCLAQ: IGGPCOBT 


If the volume is a candidate volume (one that is 


eligible to contain a VSAM data space, but doesn't yet) 


the volume’s format-4 (VTOC) DSCB is updated to 
show that the VSAM catalog is now the volume 
owner. 


5 IGGOCLAQ: IGGPIVER 


See ‘Data Areas” for details about the volume catalog 


record. 


6 IGGOCLAQ: IGGPDEFS (calls IGGPSCAT 
(IGGOCLAH)) 


The volume catalog record is identified by the 
volume’s serial number. 


C 


IGGOCLAG: IGGPBJFB 
IGGOCLAQ: IGGPDEFS 


Construct a JFCB and call the DADSM allocate 
function. 
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Diagram EG2. DEFINE SPACE: Initialize a VSAM Data Space 
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data set? 
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14. Build a data set directory entry in the 
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J data set’s use of the data space. 
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15. Write the volume catalog record into the 
catalog. 
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Notes for Diagram EG2 
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IGGOCLAQ: IGGPDEFS 


The format-1 (identifier) DSCB describes the VSAM 
data space as an OS/VS data set to the OS/VS 
DADSM routines. 


IGGOCLAQ: IGGPCOBT 


10 IGGOCLAQ: IGGPCOBT 


A VSAM data space assigned exclusively to one data 
set is, to DADSM, the same as one of the extents of an 
OS/VS data set. The data space is described by a 
format-1 (identifier) DSCB that contains the data set’s 
dsname. If a data space can be assigned to more than 
one data set, its format-1 (identifier) DSCB contains a 
dsname generated by the DEFINE SPACE routine. 


11 IGGOCLAQ: IGGPCOBT 
12 IGGOCLAQ: IGGPCSHG and IGGPCSDG 


See ‘‘Data Areas” for details about the volume catalog 
record and Data Space Group set of fields. 


14 IGGOCLAQ: IGGPCDSD 


The volume catalog record contains the identifier of 
each data set that resides (in part or in full) on the 
volume. 


See “‘Data Areas” for details about the volume catalog 
record. 


17 IGGOCLAQ: IGGPDEFS (calls IGGPLSP (IGGOCLBK)) 


19 


See OS/VS System Management Facilities (SMF) for 
the format of SMF record type 69—VSAM Data 
Space Defined or Deleted. Record type 69 is written 
when a VSAM data space is created or when its 
available space is allocated to a VSAM data set or 
index. 


A catalog recovery area is defined on the volume on 
which the space is being defined if ownership is taken 
by a recoverable catalog and the defined space does 
not contain the catalog. 


See ‘Diagnostic Aids” for details about catalog 
management return codes and error codes. 
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Diagram EH1. ALTER: Modify a Catalog Record 
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Record Field’s Value.’’) 
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Notes for Diagram EH1 


The ALTER command enables the user to modify some 
of the information he established when he created a 
VSAM data set. 


This figure describes the processes performed by catalog 
management services routines when the user issues the 
Access Method Services ALTER command in the form: 


or 


ALTER 

(entryname/password) 
[CATALOG (catname/password)] 
parameterlist 


ALTER 

entryname/ password 

FILE(dname) 

REMOVEVOLUMES (volser[bvolser...]) 


where: 


or: 


entryname is the dsname or volume serial number that 
identifies the catalog record to be modified. 


password is the record’s (identified by entryname) 
master password. 


CATALOG identifies the VSAM catalog that contains 
the record to be modified, and supplies the correct 
password for that catalog. 


parameterlist fields are described in OS/VS2 SVS 
Independent Component: Access Method Services. 


entryname, for the volume cleanup function, is the 
name of the OS/VS master catalog. 


password is the master password of the master catalog 
specified in entryname. 


dname specifies the name of a DD statement that 
identifies the volume(s) to be scratched. This 


parameter is required for the volume cleanup function. 


volser specifies the volume serial number(s) of the 
volume(s) on which all VSAM space is to be removed 
and VSAM ownership is to be relinquished. Volumes 
owned by the master catalog cannot be specified on a 
cleanup request. 


IGGOCLBD: IGGPALT 


See ‘‘Data Areas” for details about the CCA, CTGPL, 
and CTGEL. 


C 


IGGOCLBD: IGGPALT 


When the data set name or allocated candidate 
volumes are changed, other catalog records besides 
the data set catalog record must be updated. 


IGGOCLBD: IGGPALT 
IGGOCLBD: IGGPALMD 
IGGOCLBD: IGGPALT 


See OS/VS System Management Facilities (SMF) for 
the format of SMF record type 63 VSAM Data Set 
Cataloged. Record type 63 is written after a 
nonVSAM data set, cluster, or catalog is defined and 
when the definition is altered. One SMF record is 
written for each modified catalog record. 


IGGOCLBD: IGGPALT 


See “Diagnostic Aids” for details about catalog 
management return codes and error codes. 
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Diagram EH2. ALTER: Modify a Catalog Record 
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Notes for Diagram EH2 
8 IGGOCLBD: IGGPALNM 


The catalog specified by the ALTER command’s 
CATALOG parameter is examined. No other catalogs 
are examined. 


9 IGGOCLBD: IGGPALNM 


See “Data Areas” for details about the VSAM catalog 
organization, the catalog index record, the true name 
catalog record, and the data catalog record. 


11 
See OS/VS2 Data Areas for details about the DSCB. 


12 IGGOCLBD: IGGPALF1 


The name and control interval fields in the data set’s 
true name record are set to 0, and the true name 
record’s identifier field is set to C“‘F’. 


14 IGGOCLBD: IGGPALT 


See OS/VS System Management Facilities (SMF) for 
the format of SMF record type 68 VSAM Data Set 
Renamed. 
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Diagram EH3. ALTER: Modify a Catalog Record 
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of fields. (See Diagram DM 1, “Modify a Catalog 
Record Field’s Value.”’) 
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Notes for Diagram EH3 
15 IGGOCLBE: IGGPALVL 


If volume cleanup is required, IGGPALVL calls 
IGGPVRD (IGGOCLBN). Each volume in the 
user-provided volume serial number list is processed, if 
its volume catalog record exists. 


16 IGGOCLBN: IGGPVRD 


The volume(s) specified in the user-provided volume 
serial number list is mounted. After a successful 
mount, IGGPRVRD calls IGGPVRCV (IGGOCLBN). 


17 IGGOCLBN: IGGPVRD 


If a volume cannot be mounted, a 
volume-not-mounted condition is indicated in the 
volume serial list and passed back to the user. 


18 IGGOCLBN: IGGPVRCV 


Scratch each format-1 DSCB that has VSAM DSORG 
indicated. 


19 IGGOCLBN: IGGPVRCV 


The VSAM ownership, VSAM timestamp, the sum TT 
fields, and, if applicable the recovery timestamp are 
removed from the format-4 DSCB and the DSCB is 
rewritten on the volume. 


20 IGGOCLBD: IGGPALT (calls IGGPALVL (IGGOCLBE)) 
IGGOCLBE: IGGPALVA 


IGGPALVA calls IGGPSALL (suballocate) to assign 
the candidate volume to the data set. If a volume 
catalog record does not exist for the candidate volume, 
the suballocate routine returns an error code. 


See Diagram EG1, DEFINE SPACE: Assign a VSAM 
Data Space to a Catalog, for details on how a volume 
catalog record is built. 


21 IGGOCLBE: IGGPALVA 


The volume catalog record contains a data set 
directory that describes each VSAM data set’s use of 
the volume’s VSAM space. 


See “Data Areas” for details about the volume catalog 
record. 


22. IGGOCLBE: IGGPALVA (calls IGGPALSA 
(IGGOCLBE), IGGPSALL (IGGOCLAR), and 
IGGPMOD (IGGOCLAY)) 


See “Data Areas” for details about the data catalog 
record and its volume information set of fields. 


23 IGGOCLBN: IGGPALVR 


. 


24 IGGOCLBN: IGGPALVR (calls IGGPMOD 
(IGGOCLAY)) 


See ‘“Data Areas” for details about the data catalog 
record and volume information set of fields. 
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Diagram EI1. LISTCAT: Retrieve a Catalog Record’s Contents 


Virtual Storage for the Caller’s Program aM Virtual Storage for the Caller’s Program 
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CCA 
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tCTGPL Copy 


—> 1. Did the caller supply the catalog’s DSNAME? 
Yes No 


y Return the DSNAME to the caller —— 


™ 3. Did the caller specify the CTGPL “GET NEXT” 
option with record type nonzero? 
No. Yes 
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t Buffer 


List of 
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4. Was “‘Multitype’’ CTGFL specified? 


Record Must No Mugs To Identity CTGELs 
Meet each Field 
—> 5. If the catalog record meets the eas To Identify 
conditions specified in the ‘“‘multity pe”’ ea Each Field in 
a Data Set, 


CTGFL, go to step 8; otherwise go to 
step 7. 


Index, Cluster, 
or User-Catalog 
Catalog Record 


=>6. Is the retrieved catalog record the same 
type as the CTGPL record type? 
No 


Catalog Management Buffer 


Catalog Record a <<" 


Record Type | Data | 


Yes Copy of 
Caller’s 


CTGPL 


7. Retrieve the next catalog record and 
go to step 4. 


. Verify the user’s authorization to read the 
catalog information requested. 


9. Build a copy of the caller’s CTGPL and point 
to the CTGFLs required by this entry. 


10. Obtain the catalog record field’s values that 
satisfy the caller’s request (see Diagram DL. 
“Obtain a Catalog Record Field’s Value’’). 

CCAPROB 


11. Return to caller, <<a 
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Notes for Diagram EI 


The LISTCAT command enables the user to list all ora 
part of a VSAM user or master catalog’s contents. This 
figure describes the processes performed by the catalog 
management services routines when the user issues the 
Access Method Services LISTCAT command in the form: 


LISTCAT 

[CATALOG (catname[/password][dname])] 
[OUTFILE (dname) | 
ENTRIES(entrynamel/password])] 
[CLUSTER | DATA | INDEX | SPACE | 
NONVSAM | USERCATALOG | 
ALTERNATEINDEX | PATH] 

[ALL | NAME | VOLUME | ALLOCATION | 
HISTORY] 

[CREATION(days)] 

[EXPIRATION(days)] 

[NOTUSABLE] 


where: 


CATALOG identifies the VSAM catalog that contains 
the user-requested data: 


— catname 1s the dsname of a VSAM user catalog or 
the VSAM master catalog. 


— password is one of the catalog’s passwords, if the 
catalog is password protected. If the user requests 
password information from the catalog, he must 
specify the catalog’s master password. All other 
catalog information is available to the user if he 
specifies the catalog’s read password. 


— dname specifies the DD name of the catalog to be 
listed. 


OUTFILE specifies an optional alternate listing 
output data set and identifies it by dname. 


ENTRIES is a list of catalog record identifiers: 


— entryname is the dsname or volume serial number 
that identifies a catalog record. If the LISTCAT 
command includes an ENTRIES parameter list, 
only those catalog records identified by entrynames 
are listed. 


— password is one of the catalog record’s passwords. 
If the catalog’s password is supplied, the catalog 
record’s password is ignored. Otherwise, the 
catalog record’s master password allows its 
password information to be listed; its read 
password allows all other information to be listed, 
but suppresses the password information. 


[CLUSTER | DATA | INDEX| SPACE | 


C 


NONVSAM | USERCATALOG 
ALTERNATEINDEX | PATH] 


is a list that specifies the types of catalog records to be 
listed. If both the ENTRIES and this ‘types list’ 
parameter lists are specified, only those catalog 
records that are identified by an entryname and are 
included in the list of types are returned to the caller. 


° [ALL] NAME| VOLUME | ALLOCATION 
| HISTORY] specifies what part of each record to list. 


e CREATION specifies the minimum age an object 
must be to be listed. 


e EXPIRATION specifies the maximum number of days 
remaining before expiration an object may have to be 
listed. 


° NOTUSABLE specifies that only those data or index 
entries made not usable by a force delete (as opposed 
to entries made not usable by system failure, etc.) are 
to be listed. 


The LISTCAT parameters are described in OS/VS2 SVS 
Independent Component: Access Method Services. 


1 IGGOCLBQ: IGGPLSTC 


If the first character of the catalog’s name is blank, the 
caller wants the catalog name returned. 


3 IGGOCLBQ: IGGPLSTC 


If the caller did not specify the CTGPL ““GET NEXT” 
option and a nonzero CTGPL record type, only the 
one original entry pointed to by the CTGPL is listed. 


5 IGGOCLBQ: IGGPLSTC 


The multitype CTGFL specifies conditions which must 
be met by the retrieved record. The possible 
conditions are: 


a. Must be of a specified record type 
b. Must have a certain usability state 
c. Must meet a creation date value 

d. Must meet an expiration date value 


IGGOCLBQ: IGGPLSTC 


If there is no multitype CTGFL, the retrieved record 
must be the same record type as the CTGPL record 
type. 

7 ICCOCLBQ: IGGPLSTC 


The next record is retrieved by specifying the GET 
NEXT option to VSAM Record Management. 


~ 


C 


9 IGGOCLBQ: IGGPLSTC 


11 


If the entry is a volume record, only volume CTGFLs 
are pointed to from the CTGPL,; otherwise, only 
nonvolume CTGFLs are pointed to from the CTGPL. 


IGGOCLBQ: IGGPLSTC 


When all requested information has been retrieved, 
the Listcat routine sets a return code in CCAPROB 
and returns to the caller, VSAM Catalog Management 
Services Common Processing. 


See ‘‘Diagnostic Aids” for details about catalog 
management return codes and error codes. 
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Diagram EI2. Show Catalog Processing 
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Notes for Diagram EI2 


The Show Catalog processor, IGGOCLAQO, enables the 
user to obtain selected information from the VSAM 
catalog. This specialized user interface is mapped by 
macro IGGSHWPL and is invoked by the SHOWCAT 
macro. See OS/VS2 SVS Independent Component: 

VSAM Options for Advanced Applications for a complete 
description of the SHOWCAT macro. 


The SHOWCAT macro generates the Show Catalog 
parameter list and issues a LINK to module IGGOCLAO. 
Note that this module is not a part of the VSAM 
supervisory load module for SVC26, IGGOCLC9. 


1 The Show Catalog processor builds its conditional 
GETMAIN parameter list in the user-provided return 
area, 


2 The VSAM Catalog Locate interface is built in the 
Show Catalog work area acquired in step 1. The 
CTGPL work area address points to the user return 
area, 


3 The VSAM Catalog Locate function sets the required 
return area length field in the user return area and 
places the requested data into this return area. 


4 The Show Catalog processor has equivalent error 
codes for VSAM catalog return codes. 


5 The validity check ensures that data was actually 
returned and that the proper entry type is being 
requested. 


6 The transformation causes upgrade associations and 
nonupgrade associations to be returned in a consistent 
format. 


7 The Show Catalog processor always obtains a fixed 
amount of virtual storage for its work area. The user is 
responsible for providing an area of sufficient size to 
contain the returned data. If his area is not of 
sufficient size, he can use the required return area 
length field to obtain enough virtual storage to reissue 
his request. 


For additional information about topics related to Show 
Catalog processing, see: 


**‘Data Areas.” 


Catalog parameter list (CTGPL) format and 
description Catalog 


‘Diagnostic Aids.” 
Catalog management return codes 
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Diagram EJ1. DELETE: Remove a VSAM or NonVSAM Data Set 
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Notes for Diagram EJ1 


The DELETE command enables the user to remove from 
the catalog all information about a specified VSAM 
object or nonVSAM data set. 


This figure describes the processing performed by the 
catalog management routines when the user issues the 
Access Method Services DELETE command in the form: 


DELETE 

(entryname/ password) 
[CATALOG(catname/password)] 
[CLUSTER | AIX | PATH | NONVSAM] 


where: 


« entryname is the data set name of the VSAM object or 
nonVSAM data set to be deleted. 


e password is the master password of the VSAM object 
to be deleted. 


« CATALOG identifies the catalog that contains the 
record to be deleted and specifies the catalog’s 
password. 


« CLUSTER | AIX | PATH | NONVSAM specifies the type 
of object to be deleted. Deletion of these types is 
described in this diagram. To delete VSAM data 
spaces on a volume, see Diagram EK]; to delete a 
VSAM catalog, see Diagram EL1. 


The DELETE command’s parameters are described in 
OS/VS2 SVS Independent Component: Access Method 
Services. 


1 IGGOCLBG: IGGPDEL 


If the CATALOG parameter is not specified, the 
catalog record identified by the ENTRY parameter’s 
entryname is found by a search of each catalog named 
by the user’s JCL JOBCAT and STEPCAT DD 
statements, followed by a search of the VSAM master 
catalog. The catalog record identifier is examined to 
determine the record type and verify that the TYPE 
parameter, if specified, is correct. 


3 IGGOCLBG: IGGPDEL 


If the catalog is a recoverable catalog, a DD statement 
must be specified for the CRA (catalog recovery area) 
volume. 


6 IGGOCLBG: IGGPDEL 


If the user specified PURGE, the data set’s expiration 
date is ignored. See OS/VS2 SVS Independent 
Component: Access Method Services for details about 
the PURGE and RETAIN parameters. 


C 


7 IGGOCLBG: IGGPDEL 


If the user who created the data set specified the 
expiration date, the data set cannot be deleted until 
after that date (unless the PURGE parameter is 
specified; see step 6). 


9 IGGOCLBG: IGGPDEL 


If the request type is nonVSAM, go to step 16 (EJ2). 
Open determination and Erase processing do not 
apply to nonVSAM data sets. 


10 IGGOCLBG: IGGPDEL (calls IGGPDEPT (IGGOCLB5)) 


If the request type is PATH, go to step 25 (EJ3). Open 
determination, Erase, volume record, and release 
space processing do not apply to path catalog records. 


11 IGGOCLBG: IGGPDEL (calls IGGPDOPN 
(IGGOCLBG)) 


If the data set or the index of the alternate index or 
cluster is already opened, the deletion of the VSAM 
data set will not be allowed. 


13 IGGOCLBG: IGGPDEL (calls IGGPERAS 
(IGGOCLBG)) 


Each of the data set’s control areas is overwritten with 
zeros. 


15 IGGOCLBG: IGGPDEL (calls IGGPDEAX 
(IGGOCLBS)) 


Go to step 34 (EJ3) to explicitly delete an alternate 
index from the catalog. An alternate index is similar to 
a key-sequenced cluster, except a base cluster is always 
associated with an alternate index. 
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Diagram EJ2. DELETE: Remove a VSAM or NonVSAM Data Set 
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Notes for Diagram EJ2 
16 IGGOCLA7: IGGDEVG 


Each volume information set of fields is retrieved 
from the data set (index) catalog record. If the data set 
(index) is unique, the volume is mounted. 


IGGOCLA7: IGGPVMSC 


The volume catalog record is retrieved by forming a 
44-byte true name from the volume serial number field 
in the volume information set of fields. The 44-byte 
true name for the volume catalog record is the 6-byte 
volume serial number followed by 38 zeros. 


17 IGGOCLA7: IGGPDEDD 


The volume catalog record also contains a Data Set 
Directory set of fields to describe each VSAM data set 
that is contained, partially or completely, on the 
volume. If the volume is a candidate volume for a data 
set or index, the data set or index is not described by a 
Data Set Directory set of fields. 


18 IGGOCLA7: IGGPVMSC 
19 IGGOCLA7: IGGPDEDD 


If the data set’s (index’s) space is not shared (the 
“‘unique’’ flag in the data set attributes field is on), the 
data space group set of fields described by the volume 
information set of fields (sequence number of Data 
Space Group field) is deleted. 


20 IGGOCLA7: IGGPVMSC 


If the catalog is a recoverable catalog, the timestamp 
in the volume catalog record and format-4 DSCB in 
the volume’s VTOC are not altered. 


21 IGGOCLA7: IGGPDF4T 


A new timestamp is obtained from the system and the 
old timestamp in the volume catalog record and 
format-4 DSCB in the volume VTOC are rewritten 
with the new current timestamp. 


22 The OS/VS DADSM Scratch routines are called by 
issuing SVC29. The extents of the data space’s 
identifier (format-1 DSCB) and extension (format-3 
DSCB) are added to a format-5 DSCB. A free VTOC 
record (format-O0 DSCB) is written over each of the 
data space’s format-1 and format-3 DSCBs. 


23 IGGOCLBF: IGGPSSCR 


Each entry in the list identifies one of the data set’s 
(index’s) extents in one of the data spaces on the 
volume. 


C 


24 IGGOCLBF: IGGPSSCR 


Each of the data space’s extents is described in the 
Data Space Group set of fields. 
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Diagram EJ3. DELETE: Remove a VSAM or NonVSAM Data Set 
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36. Delete the AIX association set of fields from the 
base cluster indicated by the AIX control 
interval number, 


37. Go to step 16 to process the AIX catalog records. 
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Notes for Diagram EJ3 37 IGGOCLBS: IGGPDEAX 


25 IGGOCLBS: IGGPDEPT Complete steps 16 through 33 to process the alternate 
index data set, and index catalog records. 

Retrieve the path catalog record’s ‘‘base”’ catalog 
record (the base catalog record can be either a cluster 
or an alternate index catalog record) and delete the 
association set of fields in the base catalog record that 
describes the path’s control interval number. This 
action unchains the path catalog record from the 
catalog structure. 


27 IGGOCLBS: IGGPDCLS 


See OS/VS System Management Facilities (SMF) for 
the format of SMF record type 67. Record type 67 is 
written when a VSAM cluster, path, alternate index, 
or nonVSAM data set defined in a VSAM catalog is 
deleted. 


29 IGGOCLBS5: IGGPDCLS 


The DELETE routines erase the data set’s true-name 
record and delete all references to the data set’s 
DSNAME in the catalog’s index. 


30 IGGOCLBS: IGGPDCLS 


If the object catalog record type is an alternate index 
or a key-sequenced cluster, steps 16 through 29 are 
performed to delete the index catalog record. 


32 IGGOCLBS5: IGGPDCLS 


Steps 26 through 29 are performed for the cluster or 
alternate index catalog records. 


34 IGGOCLBS: IGGPDEAX (calls IGGPDIPT 
(IGGOCLBS)) 


When an alternate index is deleted, all paths 
associated with the alternate index are implicitly 
deleted first. This process is performed by retrieving 
each path record and completing steps 25 through 29. 


35 IGGOCLBS: IGGPDUPG (calls IGGPUDEL 
(IGGOCLB1)) 


The alternate index base cluster is retrieved and the 
upgrade association set of fields described by the 
alternate index’s data set (index) control interval 
numbers is deleted from the “Y”’ catalog record 
associated with the cluster’s data set. 


36 IGGOCLBS: IGGPDEAX 


Delete the association set of fields in the base catalog 
record that describes the alternate index control 
interval number. This action unchains the alternate 
index catalog record from the catalog structure. 
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Diagram EJ4. DELETE: Remove a VSAM or NonVSAM Data Set 
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Notes for Diagram EJ4 


38 When a cluster is deleted, all associated alternate index 
paths are implicitly deleted first, followed by all the 
associated alternate indexes and the associated cluster 
paths. 


Each alternate index record is retrieved and step 11 is 
performed to assure that the data sets (index) are not 
opened. Steps 34 through 36, 16 through 24, and 26 
through 32 are performed to implicitly delete all 
associated alternate indexes and alternate index paths. 


39 IGGOCLBG: IGGPDEL (calls (IGGPDIPT 
(IGGOCLBS5)) 


Retrieve each cluster’s associated path record and 
perform steps 25 through 29 for each path. 


40 IGGOCLBG: IGGPDEL (calls IGGPDUPG 
(IGGOCLBS5)) 


The ““Y” catalog record associated with the cluster 
data set record and the related association set of fields 
in the data set record is deleted. 


41 IGGOCLBG: IGGPDEL (calls (IGGPDCLS 
(IGGOCLBS5)) 


To process the cluster, data set, and index catalog 
records, perform steps 16 through 33 (skip step 25). 


For additional information about topics related to 
DELETE processing see: 


‘Data Areas.” 


Volume catalog record description 
Data set directory set of fields description and 
format 


“Diagnostic Aids.”’ 


Catalog management return codes 
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Diagram EK1. DELETE SPACE: Release All of the Empty 
VSAM Data Spaces on a Volume 
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Contents to the OS/VS system. Data Space 


(VTOC) 


F1DSCB 


VSAM Data 


Delete the Volume Catalog Record 


5. Does the volume catalog record contain any data 
space entries, or is the volume a candidate volume 

for an existing data set? (If FORCE option is on, 

do steps 6 and 7.) 


Space to be 
Released 


VSAM Catalog 
VSAM catalog as a free catalog record. 


Free Catalog 
Record 
7. Update the volume’s format-4 (VTOC) DSCB 
to show no VSAM ownership of the volume. > — 
a Updated Volume 
Catalog Record 


8. Rewrite the updated volume catalog record into @ePe eee PP ZOOS 
the VSAM catalog. 


CCAPROB 


9. Return to the caller. 2a Return Code 


c C U 


ELZ UoneIadgQ Jo poyisW 
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Notes for Diagram EK1 


The DELETE SPACE command enables the user to 
release all VSAM data spaces on a specified volume. This 
figure describes the processes performed by the catalog 
management services DELETE SPACE routine when the 
user issues the Access Method Services DELETE SPACE 
command in the form: 


DELETE SPACE 
(entryname/password) 
[CATALOG (catname/password)] 
[FILE(dname)] 

[FORCE] 


where: 


e entryname is the volume serial number of a direct 
access volume containing VSAM data spaces to be 
deleted. 


catname is the name of the catalog that contains the 
volume’s catalog record. 


¢ password is the catalog’s master, control interval, or 
update password. 


« FILE identifies the JCL statement that causes the 
volume to be mounted. 


The DELETE command parameters are described in 
OS/VS2 SVS Independent Component: Access Method 
Services. 


1 IGGOCLBL: IGGPDELS and IGGPDLVM 


If the volume isn’t already mounted and available for 
use, the DELETE SPACE routine issues the 
appropriate mount message to the operator. 


2 IGGOCLATI: IGGPFDSP and IGGPDFMI 


FORCE DELETE uses DADSM SCRATCH to 
release all VSAM data space and make it available to 
other OS/VS system users. 


3 IGGOCLBL: IGGPDLSH, IGGPDLSD, and IGGPDLCB 


The volume catalog record contains a data space 
group set of fields to describe each VSAM data space 
on the volume. 


See ‘‘Data Areas” for details about the volume catalog 
record and its data space group sets of fields. 


4 IGGOCLBL: IGGPDLSC 


The OS/VS DADSM Delete routine releases the 
empty nonunique VSAM data space and makes its 
space available to other OS/VS system users. 


C 


See OS/VS2 DADSM Logic for details about deleting 
an OS/VS data set (to DADSM, the same as a VSAM 
data space). 


IGGOCLBL: IGGPDELS 


When the volume is totally empty, the volume catalog 
record can be deleted from the catalog. This occurs 
when there are no data space group sets of fields and 
no data set directory entry sets of fields in the volume 
catalog record. 


See ““Data Areas” for details about the volume catalog 
record. 


IGGOCLBL: IGGPDLET 
IGGOCLBL: IGGPDLET 


The format-4 (VTOC) DSCB is the first entry in a 
direct-access volume’s VTOC. It contains the volume’s 
owner’s identification and information on how the 
volume is used. 


See OS/VS2 Data Areas for DSCB details. 
IGGOCLBL: IGGPDLET 


See “‘Diagnostic Aids” for details about catalog 
management return codes and error codes. 
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Diagram EL1. DELETE CATALOG: Release a VSAM Catalog 


1. Is this a FORCE DELETE request? 
No Yes 


¥ 


2. Release all data spaces. (See Diagram EK 1, 
“DELETE SPACE: Release all of the 
Empty Data Spaces on a Volume.’’) 


3. Is thisa DELETE MASTERCATALOG request? 
No Yes 


4. If PURGE is not on and current date is less CCAPROB 
than expiration date, return to the caller. aa 
5. Is FORCE option on? 
User’s Access Method Services Command Yes No 


6. Is the catalog empty? 
Yes No 


Volume that 
Contained the 
§ CCAPROB VSAM Catalog 
7. Return to caller. > 


Release a Catalog’s Data Spaces 


OS/VS Nucleus N 


Trances —] Xy 
B) 


System Queue Area 


8. Release all empty data spaces. (See Diagram EK 1, 
“DELETE SPACE. Release All of the Empty 
VSAM Data Spaces on a Volume.”’) 


Control Blocks 
that Describe 
the VSAM 
Master Catalog 
as a Data Set 


Updated VSAM 


: \ Delete the VSAM Master Catalog Catalog Flags 


P Y 
Control Blocks y ZL System Queue Area 
that Describe Vy) 
the VSAM User a 
Catalog as u 
Data Set ep rece? 
ne ‘ aw a ontro 
not open and nonexistent. es 2 P Blocks 
11. Close the VSAM master catalog’s ACB. 1 (Free 
VSAM User : CO) Virtual 
Catalog 12. Remove the VSAM master catalog’s catalog &, OS/VS System Storage) 
———— . volume (CVOL) entry from the OS/VS +>>.. Catalog 
on system catalog. (See OS/VS/ Catalog a ae 
Hee nN Management Logic, “DRPX, Disconnect  — 
VSAM Master ———— @ aCVOL.") Freespace 
Catalog For Catalog’s 
DSNAME 
For Catalog (1) 
User-Catalog Volumes Wy VSAM Master 
Delete a VSAM User Catalo 0G 
Catalog Serial Number © g fa Catalog 


Record 


Free 
Catalog 


eee | 13. Close the VSAM user catalog’s ACB. 
14. Delete the user-catalog catalog record from the Zag 


OS/VS System VSAM master catalog. Record 
Catalog © 
a CCAPROB 

eae 15. Return to the caller. eae Return Code 

Entry 


c c 


6LZ uUoyessdO Jo pope 


C 


Notes for Diagram EL1 


The DELETE USERCATALOG and DELETE 
MASTERCATALOG commands enable the user to 
release a catalog’s space and make it available to other 
OS/VS system users. The catalog must be empty (see step 
1 notes) or the request is rejected. This figure describes 
the processes performed by the catalog management 
services DELETE CATALOG routines when the user 
issues the DELETE command in the following form: 


DELETE 

(entryname/password) 

[USERCATALOG | MASTERCATALOG] 
[FORCE] 


where: 
° entryname is the dsname of the catalog to be deleted. 


¢ password is the user catalog’s master password (allows 
user catalog deletions), or the VSAM master catalog’s 
master password (allows master catalog deletions). 


e [USERCATALOG | MASTERCATALOG] identifies the 
type of catalog being deleted. 


The DELETE command parameters are described in 
OS/VS2 SVS Independent Component: Access Method 
Services. 


6 IGGOCLAF: IGGPDELC 


If the catalog contains more than two true name 
catalog records, it is not empty and cannot be deleted, 
unless the FORCE option is on. 


See ‘‘Data Areas” for details about catalog 
organization and the true name catalog record. 


8 IGGOCLAF: IGGPSDSP 


The volume catalog record contains an entry for each 
VSAM data space allocated on the volume. Each entry 
contains the data necessary to free the data space. 


See ‘‘Data Areas” for details about the volume catalog 
record. 


Diagram EK1, DELETE SPACE, shows how each 
VSAM data space is released and it’s space made 
available to other OS/VS system users. 


10 IGGOCLAF: IGGPDELC 


The communications vector table (CVT) points to the 
AMCBS which points to the control blocks which 
describe the VSAM master catalog to the OS/VS 
system. 


C 


See OS/VS2 Supervisor Logic for details about the 
CVT. 


11 IGGOCLAF 


See “‘Data Areas” for details about the ACB and for 
details of the control blocks that allow catalog records 
to be processed. 


12 IGGOCLAF: IGGPDELC 


The OS/VS system catalog contains a data set entry 
for each OS/VS private catalog and for the VSAM 
master catalog, but not for VSAM user catalogs. 


See OS/VS Catalog Management Logic for OS/VS 
system catalog and data set entry information. 


13 IGGOCLAF: IGGPDELC 


The VSAM user catalog is described, as a data set, by 
its ACB. See Diagram AD1, VSAM Close, for a 
description of closing a VSAM data set. 


See ‘‘Data Areas” for details about the ACB. 
15 


See ‘Diagnostic Aids” for details about catalog 
management return codes and error codes. 
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Diagram EM1. CONVERTV: Convert a Volume to or from Mass Storage 


Virtual Storage for the New Volume 
Caller’s Program 


Request 
Type 1. Verify the caller’s authority to convert the 


volume. 
CC ~ . 
sy 2. Check the validity of the catalog parameter list 


a and the field parameter lists. 


tc ; : 
ety = 3. Verify that the ddname is correct and the volume 
is mounted. 


. Indicate the volume is unusable for the duration 


4 
Va of conversion. 
(B) Convert volume information in the catalog that 


owns the volume 
fUCB 


VSAM Catalog 


5. Retrieve a catalog record. 4 


6. If the catalog record points to the volume, changeEAAg@eg AAPA 1 ow- Address 
the device-type indication. Range 


Repeat steps 5 and 6 until all catalog entries that 
indicate the converted volume have been processed: 


VSAM Catalog 


Low-Address 
Range 


Master Catalog 

. If a user catalog is on the converted volume. 
change the pointer to the user catalog to indicate 
the new device type. 


. Indicate the volume is usable. ELZZZZZZ2>(C) 


LLZ vonessdQ jo poy 


C 


Notes for Diagram EM1 


The CONVERTV command enables the user to convert 
the contents of a direct-access storage volume to a mass 
storage volume, or vice versa, and to have catalog 
information that indicates the old device type changed to 
indicate the new device type. 


This figure describes the processing performed by the 
catalog management services routines when the user 
issues the Access Method Services CONVERTV 
command in the form: 


CONVERTV 

FROMFILE(ddname) 

TOFILE(ddname) 

[RECATALOG(ALL | VSAMCATALOG)] 
[(CATALOG(catname[/password])] 


where: 


e FROMFILE and TOFILE identify the DD statements 
that cause allocation of the devices from and to which 
the volume’s contents are being converted. 


« RECATALOG indicates that a VSAM catalog owns 
the volume being convertet! aff indicates the extent of 
recataloging that is to be done. 


« CATALOG identifies the user catalog, if there is one, 
on the volume being converted. 


CONVERTYV is described in OS/VS Mass Storage 
System (MSS) Services for Space Management. 


1 IGGOCLBZ: IGGPCONV 


Issues the TESTAUTH macro, which checks whether 
the calling progran is an APF (authorized program 
function). 


IGGOCLBZ: IGGPVALI 


3 IGGOCLBZ: IGGPCONV 


IGGOCLBU: IGGPF4RD 
Reads the format-4 DSCB. 
IGGOCLBU: IGGPF4WR 


Writes the format-4 DSCB. If CONVERTYV fails and a 
user subsequently attempts to open a data set on the 
volume, he will receive an error code from Open. 


IGGOCLAG: IGGPPUPC 


Writes the modified volume record. The identity of 
this record is passed to IGGOCLBZ from Access 
Method Services. 


C 


IGGOLAG: IGGPRCCR 


Updates the catalog control record in the catalog that 
owns the volume to indicate the next free control 
interval. 


IGGOCLBZ: IGGPGALO 
IGGOCLAV: IGGPMOD 


Modifies device-type fields in catalog records that 
point to the volume being converted. 


IGGOCLAH: IGGPSCAT 


Searches the master catalog for the user catalog 
record. 


IGGOCLAV: IGGPMOD 


Writes the modified master catalog record that points 
to the user catalog. In step 5, IGGOCLBZ discovers 
that a user catalog is on the volume being converted 
when it finds a user catalog record that indicates the 
volume’s volume serial number. 


IGGOCLA3: IGGPRPLF 
Releases the master catalog from exclusive control. 


See step 4. 
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PROGRAM ORGANIZATION 


Module Prologues 


VSAM program listings are the key to VSAM’s organization. You get into the 
listings from the method of operation diagrams. Once you have located the 
module or routine name that interests you in the diagrams, you are ready to 
turn to the listing to find the additional information you require. 


Each VSAM module listing begins with a description of the module, called the 
module prologue. The information contained in VSAM module prologues is 
described in the topics that follow. 


Module name: The external procedure name of the module (for example, 
IFGO192A). 


Descriptive name: The English name of the module (for example, VSAM 
Open). 


Status: The version and release level of the module. 


Function: A brief step-by-step explanation of the functions performed by this 
module. Function is divided into steps so that you can more easily locate the 
routine responsible for each step. 


Notes: A generalized heading that includes (1) any dependencies, for 
example, CPU model or features, that will affect the operation of this module, 
(2) any restrictions that apply to this module, (3) symbols used to represent 
registers and register usage, (4) symbolic name of the maintenance area for 
this module and whether the maintenance area is used or reserved, and (5) 
any special terms and acronyms that are used within this module that are not 
necessarily used elsewhere in the documentation. 


Module type: A description of the type of this module (for example, 
procedure or macro), the name of the compiler used/required to create this 
module, the amount of storage required by this module for executable code 
and associated data, and the attributes of the module (for example, reentrant 
or read-only). 


Entry point: The name of the point at which control can enter this module, 
the conditions of entry, the calling sequence by which control was given, 
including any parameters passed and the names of modules that may enter at 
this entry point. 


Input: A description of anything this module gets or references, for example, 
registers, control blocks, and data. The means by which this module gains 
access to the input is included. 


Output: A description of registers, control blocks, and data areas at output; 
any messages issued as a result of this module’s processing are included. 


Exit-normal: A description of conditions at and reasons for normal exit from 
this module, including the names of modules called by this module. 


Exit-error: A description of conditions at and reasons for any error exit from 
this module. 


External references: A list of modules, data areas, etc., defined outside of or 
accessible outside of this module. 
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Tables: A list of all local tables and work areas, that is, data areas built and 
used only within this module. 


Macros: A description of system macros used by this module. 
Change activity: A list of any change activity to this module. J 


Module Flow Compendiums 


A compendium and its notes describe the flow of control between procedures 
and modules to perform a function. The compendium is a supplement to the 
function’s method of operation diagram. 


The compendium’s notes describe how each procedure and module 
contributes to the completion of the function, and under what circumstances 
the procedure or module is called. 


Reading Module Flow Compendiums 


Module flow compendiums are descriptions of VSAM functions, in terms of 
module (procedure) calls and usage. The compendium and descriptive notes, 
keyed to the compendium, are on facing pages. 


The compendium shows the flow of control between VSAM modules in order 
to perform a VSAM function. Figure 5 shows a compendium figure. A 
single-headed arrow (between IGCO001I and IFG0193A) indicates that 
control is passed from one module to another and does not return. A 
double-headed arrow indicates that control is returned when the “‘called’”’ 
module completes its processing. 


IGCOOOLI 
1 IFGO193A 
Open IFGO192A 
Parameter 
List 2 IDAOL92A 


3 [DA0192C 
@ Issues SVC 26 


See Figure 33 


4 IDA0192V 


§ IDAOI192C 
@ Issues SVC 26 


See Figure 33 


Figure 5. Program Organization Compendium Figure 


Blocks that are indented (otherwise contained within another block) are 
called to perform a specified function and return, when finished, to the caller. 
For example, IDA0192A calls IDA0192C to retrieve information from the 
catalog. 


Numbers and letters in bold-face type refer to descriptive notes. The notes tell J 
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what the caller expects the called module (procedure) to do. Figure 6 shows 
the descriptive notes to Figure 5. 


Notes for Figure 9 


> 


hw 


IGCOOOL, IFGO193A, and IFGOI9RN are OS/VS Open 
modules (see OS/V’S’ Open/Close/EOV Logic tor 
details). 


IFGOISLY tin Figure 10) XCTLSs to IFGOI93A to open a 
VSAM catalog. Open-processing and return-to-the-caller 
continues as shown in this figure. 


IDAOI92A ts the VSAM Open module. 


IDAQ192C calls VSAM Catalog Managemem (LOC ATF} 
to retrieve information about the 
VSAM-obyect-being-opened from its VSAM catalog 
record, 


IDAO192V ensures that the required minimum number of 
the object's direct-aceess volumes are mounted, 


IDAO192C cally VSAM Catalog Management (LOCATE) 
to retrieve volume serial numbers from the object's VSAM 
catalog record. 


IDA0192Z builds the following VSAM contrel blocks 
AMB Buffers FDB 

AMDSB- DEFBs IOS 

ARDB Dummy DEB PLH 

BLFC DIWA 

IDAO192W builds the CPA control block 

ID A01928 writes SMF record Ivpe 62. 


Whenever a VSAM Open module detects an error, 

ID AQL92P issues a diagnostic message and traces VSAM 
control blocks ithe Generalized Trace Facility (GTR) as 
active. 


Figure 6. Notes to Program Organization Compendium Figure 


Catalog management procedures call certain procedures so frequently that, if 
each call were shown, the catalog management compendiums would be 
cluttered. For this reason, whenever a procedure calls one of these (frequently 
called) procedures, its module identifier (last two letters of the module name: 
IGGOCLxx) is listed instead of drawing a separate block to show the 


procedure call. The frequently-called modules are: 


AG: IGGOCLAG—Catalog Management Input/Output Procedures 
AV: IGGOCLAV: IGGPMOD—Modify Catalog Field(s) 

AZ: IGGOCLAZ: IGGPEXT—Extract Catalog Field(s) 

BI: IGGOCLBI—Catalog Management Input/Output Procedures 
BV: IGGOCLBV—SMF Record Processing Procedures 

B3: IGGOCLB3—-SMF Record Processing Procedures 
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Open, Close, and End-of-Volume Compendiums 


OPEN CLOSE 


bigure 10 Figure 12 lisure 14 
Open a VSAM Close u VSAM Closes VSAM 
Catalog (from Cluster (from Catalog (from 
the OS/VS an ISAM-User’s he OS VS 

Scheduler) Program) Scheduler) 


Ligure & 
Open a VSAM 
Cluster (trom 
an ISAM-User’s 
Program) 


Pigure 13 
Close a VSAM 
Cluster (trom 
IVS AM-Lser’s 
Proerau) 


l-igure 9 

Open a VSAM 
Cluster (from 
a VSAM-User’s 
Program) 


Figure TI 
Add a 
String 
Dynamically 


CLOSE (TYPE = T) Verify Data Space Checkpoint Restart 


Figure 16 


Figure 15 are ae 
Verify Utility’s 


Temporary Close Ligure 38.1 Ligure 38.2 


Checkpoint Restart 
Processing Processing 


Authorization to 
Process Fach Data Sct 
ina VSAM Data Space 


(TYPE = T) ota 
VSAM Cluster 


End of Volume BLDVRP/DLVRP 


Ligure 1& 
Build or Delete 


higure 17 
VSAM End of Volume 
(trom VSAM Record 


a VSAM 


Management) Resource Poo! 


Figure 7. Open/Close/End-of-Volume Program Organization Contents 
SSS SSS SSS SSS SSR SS PCT 
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IGCO0011 


1 IFGO196V 


3 IDAO192I 
@ Issues SVC 19 


See Figure 9 


4 ISAM DCB Exit 


Open 
Parameter 
List 


Return 
to 
Caller 


IFG0198N 


Figure 8. Open a VSAM Cluster (From an ISAM-User’s Program) 
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Notes for Figure 8 


1 IGCO0O001I, IFGO196V, and IFG0O198N are OS/VS Open 
modules (see OS/VS Open/Close/EOV Logic tor 
details). 


2 IFG0192I is an alias for 1FG0192A. 


3 IDAO0192I is the ISAM Interface Open module. IDA0192I1 
is an alias for IDA0192A. IDA0192I issues the VSAM 
OPEN macro instruction (SVC 19). 


4 IDA0192I calls the ISAM DCB exit routine if the user’s 
program has specified one. 


Program Organization 285 


OPEN 
Sveas IGC00011 
(A) 1 1FGO193A J 


Open 
Parameter 
List 


2 


1DA0192A* 


3 IDAO0192C 


4 IDA0192F* 


IDA0192V 


6 IDAQ192D 
7 IDA0192C 


5 


8 IDAQ192B 


9 IDA0192C 


10 IDA0192Z* 


11 IDAO192Y* 


12 IDA0192W* 


13 1DA0192D 
14 IDA0192P 


15 IDA0192P 


16 IDA0192P 
17 1DA01925 


Return 
to Caller 1FGO198N 


NOTE: * indicates that the module calls IDA0192M for virtual storage. 
IDAO192M is the VSAM Virtual-Storage Manager. It builds the HEB. 


Figure 9. Open a VSAM Cluster (From a VSAM-User’s Program) 
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Notes for Figure 9 


1 IGCOO0I1I, IFGO193A, and IFGO198N are OS/VS Open 
modules (see OS/VS Open/Close/EOV Logic for 
details). 


A IFGO0191Y (in Figure 10) XCTLs to IFG0193A to open a 
VSAM catalog. Open-processing and return-to-the-caller 
continues as shown in this figure. 


2 IDA0192A is the VSAM Open module. It builds the 
following VSAM control blocks: BIB, WSHD, Dummy 
DEB. 


3 IDA0192C calls VSAM Catalog Management (LOCATE) 
to retrieve information about the VSAM object being 
opened from its VSAM catalog record. 


4 IDA0192F opens base, path, and upgrade clusters. It 
builds the following VSAM control blocks: 


ACB CMB VAT 
AMBL UPT VMT 


§ IDA0192V ensures that the required minimum number of 
the object’s direct-access volumes are mounted. 


6 IDA0192D stages (via ACQUIRE) data from mass storage 
to a direct-access storage device (staging drive). 


IDA0192C checks the time stamp. 
IDA0192B opens VSAM clusters. 


9 IDA0192C calls VSAM Catalog Management (LOCATE) 
to retrieve volume serial numbers from the object’s VSAM 
catalog record. 


10 IDA0192Z builds the following control blocks: 
AMB DEB IWA 
AMDSB_ EDB LPMB 
ARDB IRB 
11 IDA0192Y builds the: 
BUFC IOB RPL 
Buffers PLH WAX 
12 IDA0192W builds the CPA control block. 


13 IDA0192D stages (via a Mass Storage System ACQUIRE) 
data from mass storage to a direct-access storage device 
(staging drive). 


14 Whenever a VSAM Open module detects an error, 
IDA0192P issues a diagnostic message and traces VSAM 
control blocks if the Generalized Trace Facility (GTF) is 
active. 


15 Same as 14. 
16 Same as 14. 
17 IDA0192S writes SMF record type 62. 
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1 IGCoeeI! 
IFGO191X 
2 IFGO191Y 


See Figure 9 


Figure 10. Open a VSAM Catalog (From the OS/VS Scheduler) 
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Notes for Figure 10 
1 IGCOOOII is an OS/VS Open module. 


2 IFGOQ191X and IFG0O191Y are VSAM Catalog Open: ACB 
Processing modules. These modules perform special 
processing for the catalog’s ACB, then transfer control 
(using the XCTL macro instruction) to IFG0193A (in 
Figure 9). 
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OPEN 
SVC 19 


2 IDAO0192Y 


3 IDA0192M 


4 IDA0N192W 
Rl 


5 IDA0192M 


ACB 


Figure 11. Adda String Dynamically 
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Notes for Figure 11 


1 
2 


IGC001I determines whether OPEN is fora VSAM ACB. 


IDA0192Y builds control blocks necessary for Record 
Management to complete I/O requests: PLH, IOB, PFL, 
BUFC, buffer. 


IDA0192M allocates virtual storage for the requester to 
use to build control blocks. IDA0192M builds the HEB. 


IDA0192W builds a channel program area for the added 
string. 


See note for step 3. 
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RI 1 IFG0200V 


CLOSE 
SVC 20 IGC00020 


3 IDA0200S 
e Issues SVC 20 


See Figure 13 


Close 
Parameter 
List 


Return 
to IFGO202L 


Caller 


Figure 12. Close a VSAM Cluster (From an ISAM-User’s Program) 
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Notes for Figure 12 


1 


IGC00020, IFG0200V, and IFG0202L are OS/VS Close 
modules (see OS/VS° Open/Close/EOV Logic for 
details). 


IFG0200S is an alias for IFGO192A. 


IDA0200S is the ISAM Interface Close module. IDA0200S 
is an alias for IDAQ192A. 
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vert jiccovo20 | 
IGC00020 
SVC 20 moe 
(A) 1 IFGO200V 


Rl 


3 IDA0200T 


4 IDA0200B 


§ IDA0192C 
@ Issues SVC 26 


See Figure 40 


Close 
Parameter 
List 


6 IDA0192S 


7 IDA0192D 
8 IDAO192P 


9 IDA0192C 
10 IDA0192P 


IFG0O202L 


Figure 13. Close a VSAM Cluster (From a VSAM-User’s Program) 
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Notes for Figure 13 


1 


A & |S WN 


IGC00020, IFGO200V, and IFG0202L are OS/VS Close 
modules (see OS/VS' Open/Close/EOV Logic for 
details). 


IFGO200N (in Figure 14) XCTLs to IFGO200V to close a 
VSAM catalog or catalog recovery area. Close-processing 
and return-to-the-caller continues as shown in this figure. 


IFGO200T is an alias for IFGO192A. 
IDA0200T is the VSAM Close module. 
IDA0200B closes VSAM clusters. 


IDA0192C calls VSAM Catalog Management (UPDATE) 
to modify statistical information in the object’s VSAM 
catalog record. 


IDA0192S writes SMF record(s) type 64. 


IDA0192D destages (via a Mass Storage System 
RELINQUISH) the data from direct-access storage to 
mass storage. 


Whenever IDA0200B detects an error, IDA0192P issues a 
diagnostic message. 


When a catalog is being closed, IDA0192C calls VSAM 
Catalog Management (LOCATE) to indicate that Close 
has finished processing. 


10 IDA0192P issues a diagnostic message whenever 


IDA0O200T detects an error. 
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1 1GC00020 
2 IFG0O200N 


See Figure 13 


t Catalog’s 
ACB 


Figure 14. Close a VSAM Catalog (From the OS/VS Scheduler) 
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C 


Notes for Figure 14 


1 


IGC00020 is an OS/VS Close module (see OS/VS 
Open/Close/EOV Logic for details). 


IFG0200N is the VSAM Catalog Close: ACB Processing 
module. It performs special processing for the catalog’s 
ACB, then XCTLs to IFGO200V (in Figure 13). 
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TCLOSE 
SVC 23 1 IGCOQ002C 


R1 


4 IDA0231B 


5 IDA0192D 


Close 
Parameter 
List 


6 IDA0192C 
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Figure 15. Temporary Close (TYPE=T) of a VSAM Cluster 
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Notes for Figure 15 


1 


IGC0002C and IFG0232Z are OS/VS CLOSE (TYPE=T) 
modules (see OS/VS Open/Close/EOV Logic for 
details). 


IFG0231T is an alias for IFGO192A. 
IDA0231T is the VSAM CLOSE (TYPE=T) module. 


IDA0231B is the VSAM CLOSE (TYPE=T) module for 
closing clusters. 


IDA0192D destages (via a Mass Storage System 
RELINQUISH) the data from direct-access storage to 
mass storage. If the data was not bound in direct-access 
storage, IDA0192D restages (via a Mass Storage System 
ACQUIRE) the data from mass storage to direct-access 
storage. 


IDA0192C calls VSAM Catalog Management (UPDATE) 
to modify statistical information in the object's VSAM 
catalog record. 


IDA0192S writes SMF record(s) type 64. 


Whenever IDA0231B detects an error, IDA0192P issues a 
diagnostic message. 


IDA0192P issues a diagnostic message whenever 
IDA0231T detects an error. 
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See Figure 40 


2 IDA0192G 
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LOCATE 


See Figure 40 


Figure 16. Verify a NonVSAM Caller’s Authorization to Process Each Data Set ina VSAM Data Space 
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Notes for Figure 16 


The VTOC contains a format-1 (identifier) DSCB to describe 
each VSAM data space. The DSCB indicates that the space it 
describes is protected and that the caller must provide the 
correct password before access is granted. 


When a VSAM data space is shared (nonunique), the caller 
must provide the correct master password for each data set in 
the data space before he is allowed to process the data space. 


1 When the caller is the OS/VS DADSM Scratch Routine 
and the format-1 DSCB identifies a VSAM data space, 
SECLOADA passes control to IDA0192G. (See OS/VS 
Open/Close/EOV Logic for SECLOADA details.) 


2 When the caller is authorized (is in key 0 and supervisor 
state), IDA0192G does no further checking. 


3 When a utility program issues OPEN, CLOSE, or EOV, 
IFGO19ST determines that the caller is other than VSAM 
or ISAM-Interface and that the format-1 DSCB is 
protected. (See OS/VS Open/Close/EOV Logic for 
details.) 


4 IDA0192G verifies the caller’s authorization to process 
the data space. 


5 IDA0192C issues SVC 26 (GENDSP) to VSAM (catalog 
management) to obtain the dsname of each VSAM data 
set in the data space. : 


6 IDA0192C issues SVC 26 (LOCATE) to catalog 
management to verify that the caller can supply each 
protected data set’s master password. 
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Figure 17. VSAM End of Volume (From VSAM Record Management: IDAEOVIF Procedure (in Module IDA019R5)) 


302 OS/VS2 SVS Independent Component: Virtual Storage Access Method (VSAM) Logic 


Notes for Figure 17 


1 


8 
9 


IGCOOOSE and IFG0O551F are OS/VS End of Volume 
modules (see OS/VS Open/Close/EOV Logic for 
details). 


IFGOS5SOY is an alias It performs special processing for the 
VSAM catalog’s ACB and is called when EOV is issued 
against a VSAM catalog. 


IFG0557A is an alias for IFGO192A. 
IDA0557A is the VSAM End of Volume module. 


IDA0192V ensures that the required volumes are mounted 
for the VSAM object. 


IDA0192C calls VSAM Catalog Management (UPDATE) 
to modify information in the object’s VSAM catalog 
record. 


IDA0192D stages (via a Mass Storage System ACQUIRE) 
new extents to a direct-access storage device (staging 
drive). 


Same as step 7. 


IDA0192S writes SMF record(s) type 64. 


10 IDA0192C calls VSAM Catalog Management (LOCATE 


and UPDATE) to locate and update information in the 
object’s VSAM catalog record. 


11 Whenever a VSAM End of Volume module detects an 


error, IDA0192P issues a diagnostic message and traces 
VSAM control blocks if the Generalized Trace Facility 
(GTF) is active. 
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Figure 18. Build or Delete a VSAM Resource Pool 
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Notes for Figure 18 


1 IGCOOO01I determines whether SVC19 1s for BLDVRP or 
DLVRP. 


2 IDA0192Y builds or deletes control blocks fora VSAM 
resource pool: VSRT, WSHD, CPA header, PLHs, BSPH, 
BUFCs, buffers. For BLDVRP, it chains the VSRT to the 
VAT; for DLVRP, it unchains it. 


3 IDA0O192M allocates virtual storage for the requester to 
use to build control blocks. IDA0192M builds the HEB. 
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Figure 19. Record Management Program Organization Contents 
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GET 
BALR R14, R15 


RO 


Request 
Type 


Return 
Address 


R15 
Return 
Code 
Return 
to 
Caller 


1 IDAO19R1 


2 IDA019R4 


3 IDAOI9RA 
(See Figure 22) 


4 IDA019R4 
DATARTV 


Spanned Record 


5 IDA0O19RT 
IDADARTV 


6 IDAO19RZ 
IDAFREEB 


7 IDAOL9ORZ 
IDAGNXT 


Direct GET 


8 IDA019R4 
RLSEBUFS 


9 IDAO19RZ 
IDAWRBFR 


10 IDA019R3 


11 IDA019RZ 
IDAFREEB 


12 IDA019RZ 
IDAFREEB 


13 IDAO19RP 
IDATJXIT 


Figure 20. GET: Direct and Skip Sequential Processing (ESDS, KSDS) 
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Notes for Figure 20 


1 


IDAO19R1 is the common Record Management request 
module. It verifies that the request is a valid Record 
Management macro instruction, then tests the RPL for 
keyed or addressed processing. 


When the request requires either keyed or addressed 
processing (not a control-interval-processing request), 
IDA019R4 selects the correct processing path for either 
GET, PUT, or POINT, and for sequential, skip sequential, 
or direct processing. 


When the request is either direct GET or skip sequential 
GET, IDA019RA locates the position of the desired data 
record in its control interval. 


DATARTV makes an unspanned data record available to 
the caller. It sets the RBA of the data record into the RPL. 
If the caller’s request is in locate mode, DATARTV 
returns a pointer to the record to the caller. If the request 
is in move mode, DATARTV moves the data record into 
the caller’s record area. 


IDADARTV moves all the segments of a spanned record 
into the user's area, 


IDAFREEB frees the buffer. 
IDAGNXT moves the next segment into a buffer. 


If the request is direct GET and the caller doesn’t want to 
retain the record’s position for subsequent record 
processing requests, RLSEBUFS releases the data record’s 
buffer. 


If the buffer was changed by a previous update request, 
IDAWRBER rewrites the buffer’s control interval into the 
data set. 


10 IDA019R3 builds the required I/O CCW chain and issues 


an EXCP macro instruction to rewrite the record on the 
direct access device. 


11 IDAFREEB frees the data buffer. 
12 If the request is keyed, IDAFREEB frees the buffer 


containing the sequence-set control interval associated 
with the data buffer. 


13 If the user’s EXLST contains an active journal exit 


address, IDATJXIT provides the necessary journaling 
information for the user’s journal exit routine. 
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Figure 21. GET: Sequential Processing (ESDS, KSDS) 
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Notes for Figure 21 


1 IDA0O19R1 is the common Record Management request 
module. It verifies that the request is a valid Record 
Management macro instruction, then tests the RPL for 
keyed or addressed processing. 


2 When the request requires either keyed or addressed 
processing (not a control-interval-processing request), 
IDAO19R4 selects the correct processing path for either 
GET, PUT, or POINT, and for sequential, skip sequential, 
or direct processing. 


3 When the request is sequential GET, PLHEXP tests the 
status indicators in the placeholder (PLH) to determine if 
an exceptional condition occurred: 


« Ifthe request is the first request after the data set is 
opened, and isn’t preceded by a POINT to position to a 
starting record: 


4 If the request is addressed, IDAGRB reads in the 
first data control interval of the data set. IDA0Q19R3 
issues the I/O CCW chain required to read the 
control interval from the direct access device. 


§ If the request is keyed, IDAGRB reads in the first 
sequence-set control interval. IDA019R3 issues the 
I/O CCW chain required to read in the control 
interval from the direct access access device. 


6 The sequence-set control interval is used to 
determine the RBA of the first data control 
interval. IDAGRB retrieves the first data control 
interval of the key-sequenced data set. 


7 If the first control interval of the key-sequenced 
data set is empty, IDAFREEB frees its buffer. 


8 IDAGNXT obtains the next control interval of the 
key-sequenced data set. Steps 7 and 8 are repeated 
as often as necessary to obtain a nonempty control 
interval of the key-sequenced data set. 


e Ifthe end of data condition occurs, PLHEXP sets a 
return code and returns to the caller. 


e If aread error occurs, ADVPLH skips over the bad 
data, resets the PLH so that it points to the next good 
data control interval’s RBA, and returns to the caller 
with a return code set. 


e Ifthe previous request encountered a read-exclusive 
error (not allowed to read the record because another 
user has exclusive control over it), SCANDATA 
searches the index to locate the requested record. 


9 If no exceptional conditions have been detected, the PLH 
now points to the record most recently processed by the 
user. ADVPLH adjusts the PLH so that it points to the 
next record (desired by this request) in the buffer. 


10 If there are no more records in the buffer (that is, the 
record most recently processed by the user is the control 
interval’s last record), IDAFREEB frees the buffer. 


11 IDAGNXT retrieves the next sequential control interval, 
unless another buffer already contains the control interval. 
The PLH is set to point to the first data record in the 
control interval. 


12 If no exceptional conditions have been detected, the PLH 
now points to the record most recently processed by the 
user. IDAADVPH adjusts the PLH so that it points to the 
previous record (desired by this request) in the buffer. 


13 If there are no more records in the buffer (that is, the 
record last processed by the user is the control interval’s 
first record), IDAFREEB frees the buffer. 


14 IDAGNXT retrieves the next sequential control interval 
(by descending RBA), unless another buffer already 
contains the control interval. The PLH is set to point to 
the last data record in the control interval. 


15 If the current request is GET-for-update, but the record’s 
buffer is not under the caller’s exclusive control, 
SCANDATA locates the record again to ensure that the 
PLH now points to it, even though updates might have 
occurred against it. The buffer is now under the caller’s 
exclusive control. 


16 IDAO19RA searches the index, if the data set is 
key-sequenced, or uses the caller-supplied RBA, if the data 
set is entry-sequenced, to determine the record’s location 
in the buffer. 


17 If the placeholder needs to be updated, ADVPLH updates 
it after the record has been located. 


18 DATARTYV makes an unspanned data record available to 
the caller. It sets the RBA of the data record into the RPL. 
If the caller’s request is in locate mode, DATARTV 
returns a pointer to the record in the caller’s RPL. If the 
request is in move mode, DATARTV moves the data 
record into the caller’s record area. 


19 MOVEKEY saves the record’s key in the placeholder. 


20 If the user’s EXLST contains an active journal exit 
address, IDATJXIT provides the necessary journaling 
information for the user’s journal exit routine. 


21 IDADARTV moves all the segments of a spanned record 
into the user’s area. 


22 IDAFREEB frees the buffer. 
23 IDAGNXT moves the next segment into a buffer. 
24 See the note for step 20. 
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Figure 22. Obtain the Control Interval Containing a Specified 
Record and Establish the Position of the Record in 
the Control Interval (ESDS, KSDS) 
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Notes for Figure 22 


1 


IDAOI19RA locates the position of a desired data record in 
a control interval that is ina VSAM Record Management 
buffer. 


If the control interval is being updated by another user, 
IDAWAIT waits until the updating is complete. 


If the data set is key-sequenced, IDAO19RB searches the 
index to find the RBA of the desired data record’s control 
interval. 


IDAGRB obtains an index record to search. 


IDAO19R3 issues the I/O CCW chain required to read the 
control interval into a buffer, if another buffer doesn’t 
already contain the control interval. 


IDAOI19RC searches the index control interval to locate an 
index entry containing a key value equal to or greater than 
the search argument passed by IDA019RB. IDA019RC 
sets a return code to indicate the status of the search, and 
a pointer to the requested entry, if found. 


If IDAO19RC hasn’t found the termination point for the 
search (determined by IDA019RB), IDAFREEB releases 
the buffer containing the just-searched index control 
interval. Steps 4 through 7 repeat until the termination 
point for the search is reached. 


If the placeholder doesn’t point to the buffer containing 
the desired data record, IDAFREEB frees the buffer 
currently pointed to by the PLH. 


IDAFRBA determines the RBA of the next sequential (or, 
if the request is keyed, the next higher keyed) control 
interval. 


10 IDASBF releases all buffers (except one) pointed to by the 


placeholder—buffers that have been assigned to the 
placeholder and available for its use, but are not currently 
in use. 


11 IDAGRB retrieves the data record’s control interval, 


located by the previous index search if the data set is 
key-sequenced or by the caller-specified RBA value is the 
data set is entry-sequenced. 
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Figure 23. GET Processing (RRDS) 
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C 


Notes for Figure 23 


1 IDAO19R1 is the common Record Management request 
module. It verifies that the request is valid and checks for 
keyed processing of a relative record data set. 


2 IDAOI9RR selects the processing path for GET, PUT, 
POINT, or ERASE and for direct, sequential, or skip 
sequential access. 


Direct or Skip Sequential 


The search argument (relative record number) is 
converted to the RBA of the control interval that contains 
it and the offset of the record in the control interval. 


3. For skip sequential access, IDARRDRL verifies that the 
search argument is greater than the previous one, 
indicated by positioning. 


4 IDAGRB retrieves the control interval by RBA, and 
IDARRDRL sets the PLH pointer to the record. 


Sequential 


5 For sequential retrieval, positioning must have been 
established. Status indicators in the PLH indicate any 
exceptional condition, which is handled by PLHEXP: 


e For the first request after OPEN, positioning is 
implicitly established at the beginning or the end of the 
data set (depending on whether processing is to be 
forward or backward). Steps 6 through 10 handle this 
exceptional condition. 


¢ Ifthe end of the data set (or the beginning, for 
backward processing) has already been reached, 
PLHEXP sets an error code and returns to the caller. 


e If there has been a read error, PLHEXP calls 
ADVPLH, which skips over the unreadable control 
interval, searches for the next slot that contains a 
record, and sets the PLH pointer to the record. 


e If the control interval couldn't be retrieved before 
because another request had exclusive control of it, 
PLHEXP calls GETXCTL to retrieve the control 
interval. 


6 IDAABF adds buffers to the buffer chain for read-ahead 
buffering. 


7 IDAGRB retrieves the first control interval and scans it 
for the first slot that contains a record. 


8 Ifthe control interval doesn’t contain a record, ADVCI 
advances to the next control interval, and the next, until it 
finds a slot that contains a record. 


9 IDAFREEB frees the current data buffer. 
10 IDAGNXT retrieves the next sequential control interval. 


11 For processing when there is no exceptional condition, 
ADVPLH advances to the next slot that contains a record 
and sets the PLH pointer to the record. 


12 ADVCI advances to the next slot that contains a record. 
13 IDAFREEB frees the current data buffer. 
14 IDAGNXT retrieves the next sequential control interval. 


15 For GET-update, when the buffer isn’t already under 
exclusive control, GETXCTL retrieves the control interval 
with exclusive control of the buffer that contains it. 


16 IDARRDRL retrieves the control interval by RBA and 
sets the PLH pointer to the first slot that contains a 
record. 


Common Termination 


17 COMGET sets RPL fields for the user, updates statistics, 
and releases positioning, if necessary. 


18 For a direct request that is not for update, not to have 
string position noted, and not in locate mode, IDAFREEB 
frees the current data buffer. 


19 If the user's EXLST contains an active journal exit 
address, IDATJXIT provides the necessary journaling 
information for the user’s journal exit routine. 
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Figure 24. PUT Processing (ESDS, KSDS) 
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(See Figure 22) 
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Notes for Figure 24 


1 IDAO19R1 is the common Record Management request 
module. It verifies that the request is a valid Record 
Management macro instruction, then tests the RPL for 
keyed or addressed processing. 


2 When the request requires either keyed or addressed 
processing (not a control-interval-processing request), 
IDA019R4 selects the correct processing path for either 
GET, PUT, or POINT, and for sequential, skip sequential, 
or direct processing. 


3. When the request is PUT-update, IDA019R4 verifies that 
the previous request was a GET-for-update. When the 
request is either PUT-update or ERASE, IDA019RL 
either replaces the old record’s contents with updated 
information (PUT-update) or removes the old record from 
the data control interval. 


4 When the record is added sequentially to a key-sequenced 
data set, SQICHECK ensures that the new record’s key is 
in the correct sequence. 


§ If the caller’s previous request didn’t establish a position 
in the data set, or if the key of the record to be inserted is 
greater than the key for the current position, IDA019RA 
searches the index to find the correct position for the new 
record to be inserted. IDAO19RA returns a pointer to the 
insertion point for the record in the buffer. This process 
occurs only after the data set has been created. 


6 When the first record of a data set is being written, 
IDAGNNEL obtains an empty buffer to build the control 
interval’s records in. This process occurs only when the 
data set is being created. 


7 When the request is a direct or skip-sequential insert into 
an entry-sequenced data set, GETINCI ensures that the 
last control interval that contains data records is available 
to receive the new data record. 


8 IDAQ0O19RA locates the correct control interval and reads it 
into a buffer (if the request is direct). 


9 When the request is a direct or skip-sequential insert into a 
key-sequenced data set, IDAO19RA searches the index to 
locate the correct sequence-set and data control interval, 
and reads both control intervals into buffers. 


10 IDA019RM inserts the record into the buffer at a 
previously determined insertion point. IDA019RM builds 
the record’s RDF and inserts the record into the control 
interval, adjusting other records as necessary. 


11 If the request is direct PUT and the caller doesn’t want to 
retain the record’s position for subsequent record 
processing requests, RLSEBUFS releases the data record’s 
buffer. 


12 If the buffer was changed by a previous update request, 
IDAWRBER rewrites the buffer’s control interval into the 
data set. IDA019R3 issues the required I/O CCW chain to 
rewrite the record on the direct access device. 


13 IDAFREEB frees the buffer when it has been rewritten 
into the data set. 


14 If the user’s EXLST contains an active journal exit 
address, IDATJXIT provides the necessary journaling 
information for the user’s journal exit routine. 


15 IDA019RM calls IDAQ19RT for spanned-record insertion. 


16 See note for step 15. 


17 If the current buffer isn’t empty, IDA019RE is called to 
split the control interval. 


18 If the control area hasn’t enough free space for the 
spanned record, IDAO019RF is called to split the control 
area. 


19 IDA019RC finds the position of the current entry in the 
sequence set. 


20 IDAMVSEG moves one segment from the user's area to a 
buffer. 


21 IDAADSEG builds a sequence-set entry for the segment. 
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Figure 25. Update/Erase Processing (ESDS, KSDS) 
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(See Figures 26 
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Notes for Figure 25 


1 IDAOI19RL removes an unspanned record from a control 
interval (ERASE), updates a previously read unspanned 
record if the length doesn’t change (PUT-update), or, if an 
updated record’s length is different, erases the record’s 
contents in the control interval, and calls IDA019RM to 
insert the record into the control interval (PUT-update). 


2 If arecord was erased, IDATJXIT provides the necessary 
journaling information for the user’s journal exit routine. 


If the record is a different size, IDAO19RM inserts it. 


4 If the control interval must be split (the new information 
is greater than the amount of free space in the control 
interval), the control interval’s original records (before the 
split) are journaled. IDATJXIT provides the necessary 
journaling information for the user’s journal exit routine. 
data buffer. 


§ CIFUL processes the control interval when it is full and its 
contents is split (put into two control intervals). 


6 The control-interval-split process requires the exclusive 
use of the DIWA control block. If another request is using 
the DIWA, IDADRQ waits until the DIWA is available. 


7 IDAOI9RE splits the control interval. 


See Figure 26 when the control interval is split during data 
set creation or during entry-sequenced data set processing. 


See Figure 27 when the control interval is split during 
key-sequenced data set processing after the data set is 
created. 


8 IDAOI9RS erases or updates a spanned record. 
9 IDAOI9RC locates the record’s entry in the sequence-set. 


10 CLEARSEG gets a buffer, clears it to free space, and 
writes it to auxiliary storage. 


11 DELSEG removes a segment’s entry from the 
sequence-set. 


12 IDAWRBER writes the updated sequence-set record. 


13 IDAOI9RF splits the control area if the updated record 
has additional segments for which free control intervals 
aren't available in the control area. 


14 IDA019RC locates the record’s entry in the sequence-set. 


15 IDAMVSEG moves a segment from the user's area to a 
buffer. 


16 CLEARSEG clears to free space the control intervals 
occupied by segments removed from an updated record. 


17 DELSEG removes a segment’s entry from the 
sequence-set when the updated record has fewer segments 
than the original record. 


18 IDAADSEG builds entries in the sequence-set for 
additional segments in the updated record. 


19 IDAWRBER writes the updated sequence-set record. 
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Figure 26. Obtain the Next Control Interval: Create Processing and Entry-Sequenced Data Set Processing 
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EOCA 
(See Steps 4 - 8) 


Notes for Figure 26 


1 IDAO19SA obtains the next (sequential) control interval 
to contain the data records. IDA019SA selects this path 
when the data set (key-sequenced of entry-sequenced) is 
being created, or when an entry-sequenced data set is 
being processed. 


2 IDAO19RG builds an index entry (in the sequence-set 
control interval) for the full data control interval. 


3 VSAM is designed so that the sequence-set control interval 


can contain an index entry for each data control interval 


in a control area. Sometimes, when the keys are very long, 


the sequence-set control interval is filled even though 
some of the control intervals haven’t been loaded with 


data records yet. When this occurs, IDA019RG (at step 2) 
returns a condition code indicating that the index entry for 


the full data control interval hasn’t been built. EOCA 
writes each unused control interval in the control area 


(associated with the full sequence-set control interval) as a 


free control interval. EOCA then writes the full data 
control interval into the first control interval of the next 
control area. 


4 IDAWRBEFR writes the full buffer containing the data 


control interval into the data set (the first control interval 


of the next control area). 


5 If the caller is creating the data set and specified the 


‘speed option’’, the unused control intervals in the control 
area have not been preformatted. IDA019RK preformats 


them—rewrites them as free-space control intervals. 


6 If the data set (or key range, if this describes step 14’s 


EOCA) is out of space, IDAEOVIF calls the VSAM End 


of Volume routine to obtain another secondary space 
allocation for the data set (or key range). 


7 IDAO19RG writes the full sequence-set control interval 
into the index. 


8 If the caller specified the ‘‘recovery option”, IDA019RK 


preformats the next control area’s control intervals. 


9 IDATSXIT provides journal information about the data 
that is going into the new control area for the user’s 
journal exit routine. 


10 IDA019RG builds an index entry to describe the first 


control interval in the new control area and puts it into the 


new control area’s sequence-set control interval. 


11 IDAFREEB frees the buffer that contains the full data 
control interval. 


12 IDAGNNFL obtains an empty buffer to continue the 
caller’s data set create proccessing. 


13 BUILDFS initializes the buffer as a free-space control 
interval. 


14 When the caller’s key-sequenced data set is divided into 
key ranges and the key of the record being added is 


greater than the high key of the key range, EOCA writes 
the buffer containing the control area’s last record into the 


control area. EOCA then writes each unused control 


interval in the control area as a free-space control interval. 


EOCA determines the RBA of the next key-range’s first 
control area and writes the record into the new control 
interval. 


15 When the caller’s new record exceeds the capacity of the 


last control interval in the control area, EOCA determines 
the next control area and performs necessary processing 
to allow the caller to continue data set create processing. 
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Figure 27. Split a Control Interval: Key-Sequenced Data Set, NonCreate-Time Processing 
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Notes for Figure 27 


1 IDAO19RE divides a control interval’s records between 
the control interval and a free-space control interval. 


2 If the sequence-set record associated with the control 
interval has been modified by some other request, 
IDAGRB obtains a current copy of the sequence-set 
control interval in a buffer. 


3 If the data control interval has been modified by another 
request before it has been written back to the data set, 
IDAWRBEFER writes the updated control interval into the 
data set. 


4 If the control interval’s control area doesn’t contain a 
free-space control interval, IDAO19RF splits the control 
area. 


5 IDAGNNEL obtains an empty buffer. The buffer is used 
to build the new data control interval, using records from 
the control interval being split. 


IDAO19RE distributes the records between the current 
control interval (being split) and the new control interval 
(in the newly obtained buffer). 


6 IDAO19RM inserts the data record (the record that 
wouldn’t fit and caused the control interval split) into the 
control interval. 


7 IDAO19RH builds an index entry for the new control 
interval. IDA019RH also puts the entry in the 
sequence-set control interval associated with the control 
area. 


8 Ifthe entry won't fit in the sequence-set control interval, 
IDAO19RE forces a control area split. IDAFREEB frees 
the buffer that was obtained to contain the new data 
control interval. 


9 IDAOI9RF splits the control area. 


10 If the user’s exit list contains an active journal exit 
address, IDATJXIT provides journaling information 
about the control area split and the data records that were 
moved from one control interval to another. 


11 If the user’s exit list contains an active journal exit 
address, IDATJXIT provides journaling information 
about the data records that were moved within the control 
interval to allow the new data record to be inserted. 


12 IDAWRBFR writes the new control interval into the data 
set. Of the two control intervals that resulted from the 
control interval split, this control interval contains the 
records with the highest keys. 


13 IDA019RH writes the updated sequence-set record (from 
step 17). 


14 IDAWRBFR writes the updated (old) control interval into 
the data set. 


15 IDAFREEB frees the buffer obtained during step 5. 
IDAOI9RE repositions the sequence-set pointers to point 
to the data control interval into which the insert was made 


16 IDASBF releases all other buffers associated with the 
placeholder (PLH). 
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Figure 28. Split a Control Area 
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Notes for Figure 28 


1 IDAO19RF moves some of a control area’s control 
intervals into a free-space control area. 


2 If afree-space control area is not available, IDAEOVIF 
calls VSAM End of Volume to obtain more space for the 
data set. 


3 IDAGRB obtains a current copy of the control area’s 
sequence set record. 


4 IDA0O19RK preformats the free-space control area. 


If the control area can't be split because it is filled with a 
single spanned record, IDA019SF builds a new 
sequence-set record and clears a data buffer to free space. 


IDAFREEB frees the current sequence-set buffer. 
IDANEWRD initializes a new sequence-set record. 
New Key Less Than Old Key 


(The ‘‘old” key is the key of the spanned record that fills 
the control area.) 


8 IDAWRBEFER writes the new sequence-set record. 


9 IDAOI9RV obtains the sequence-set record that 
precedes the sequence-set record of the control area 
filled with the spanned record. IDA0O19RV changes the 
sequence-set record’s horizontal pointer to point to the 
new sequence-set record (step 7). 


10 IDAWRBER writes the sequence-set record (step 9). 
New Key Greater Than Old Key 
11 IDAWRBEFR writes the new sequence-set record. 


12 IDAGRB reads the sequence-set record of the control 
area filled with the spanned record and changes its 
horizontal pointer to point to the new sequence-set 
record. 


13 IDAWRBFR writes the sequence-set record (step 12.) 


14 IDAHLINS changes the second-level index record to point 
to the new sequence-set record. 


15 IDAABF obtains as many buffers as possible to allow the 
‘Control Area Split routine to function as smoothly as 
possible. The maximum number of buffers obtained is 
equal to the number of control intervals to be moved into 
the new control area. The buffers are used to copy control 
intervals from the old control area and rewrite them into 
the new control area. 


16 IDAGRB obtains a copy of the first control interval that is 
to be copied into the new control area. 


17 When this sequence is repeated for subsequent control 
intervals, IDAGNXT obtains the next sequential data 
control interval in the control area until all control 
intervals that are to be moved have been processed. 


IDAO19RF modifies the output RBA value in the control 
interval buffer’s BUFC, so that the control interval is 
written into the new control area. 


18 IDAFREEB frees the buffer. The buffer’s contents will be 
written into the new control area; when it is used again to 
contain another control interval. 


Steps 17 and 18 are repeated for each control interval in 
the old control area that is moved into the new control 
area. 


19 IDAWRBER writes all buffers not yet written into-the new 
control control area. 


20 IDAO19RI builds a new sequence-set record for the 
control area and adjusts other higher-level index records 
to point to the new sequence-set record. 


21 IDAGRB obtains a current copy of the old control area’s 
sequence-set record. 


22 If the user’s exit list contains an active journal exit, 
IDATSIXIT provides journaling information about the 
control interval being moved—its old and new RBAs. 


If the sequence-set record could not be split at the point 
the data was split, some control intervals in the new 
control area are removed from the new control area so 
that both old and new seqeunce set records are accurate. 
These control interval’s are rewritten as free-space control 
intervals in the new control area; they remain intact in the 
old control area. Steps 23 through 25 process this 
exceptional condition. 


23 IDAGNNEL obtains an empty buffer. 
IDAO19RF builds a free-space control interval in it. 


24 IDAFREEB frees the buffer, so that it will update the 
control area with a free-space control interval when the 
buffer is used next. 


25 IDAWRBER writes all buffers not yet written into the new 
control area. 


26 IDAGNNEL obtains an empty buffer. 
IDAO19RF builds a free-space control interval in it. The 
free-space control interval replaces each control interval 
in the old control area that has been copied into the new 
control area. 


27 IDAFREEB frees the buffer, so that it will update the old 
control area with a free-space control interval when the 
buffer is used next. Steps 26 and 27 are repeated until all 
control intervals in the old control area that have been 
copied are deleted. 


28 IDAWRBER writes all buffers not yet written into the old 
control area. 


29 If the insert point for the record to be added to the data 
set is in the new control interval, IDAFREEB frees the 
buffer that contains the old sequence-set control interval. 


30 IDAGRB obtains a copy of the sequence-set control 
interval associated with the new control area. 


31 If the record is to be inserted at the end of the data set, 
IDA019RM inserts the record. No further control area 
split processing is performed. 


If the record is not to be added to the end of the data set: 


32 IDASBF releases all buffers associated with the 
placeholder, except the buffers contained the data record’s 
insert point and the sequence-set control interval. 


33 Same as step 32. 


34 IDAGRB obtains a current copy of the data control 
interval that contains the data record’s insert point. 


IDAO19RF returns to the control interval split routine to 
split the control interval and insert the data record. 
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Figure 29. Create-Time Sequence-Set Record Processing: 
Build an Entry 
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Notes for Figure 29 


IDA019RG is called by IDA019SA when a key-sequenced 
data set is being created. 


1 This figure describes the addition of an index entry to the 
sequence-set control interval when a data control interval 
is full. 


2 If IDAOI9RG is being called for the first time, IDAAQR 
obtains a control interval for a sequence-set record. 


3 If all allocated space in the data set has been used, 
IDAEOVIF obtains another extent for the data set. 


4 If the newly obtained extent must be preformatted before 
it can be used, IDAO19RK preformats it. 


5 INTNEWRC initializes the control interval as a 
sequence-set control interval. 


6 IDAGNFL obtains a buffer for the sequence-set control 
interval. 


7 IDAIST uses the high key value of the data control 
interval to build an index entry in the sequence-set control 
interval. The key is front and rear compressed before the 
entry is built. 


If there is not enough room to insert the index entry in the 
sequence-set control interval, IDA019RG indicates this 
and returns to IDAO19SA. The entry is not put in the 
sequence-set record. 
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Figure 30. Create-Time Sequence-Set Record Processing: Write the Record (End of Control Area) 
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Notes for Figure 30 


1 When the control area is full, IDAOQ19RG writes its 
sequence-set record into the index and initializes a new 
sequence-set record for the new control area. 


2 IDAWR writes the updated sequence-set record into the 
index. This is the sequence-set record associated with the 
old control area. 


3 IDAAQR obtains the next control interval for a 
sequencesett record. 


If all allocated space in the data set has been used, 
IDAAQR calls IDAEOVIF to obtain another extent for 
the data set. 


If the newly obtained extent must be preformatted before 
it can be used, IDAAQR calls IDA019RK to preformat it. 


4 INTNEWRC initializes the control interval as a 
sequencesett record. 


IDAGNEFL obtains a buffer for the sequencesett record. 


6 IDAWR writes the new sequence-set record with a dummy 
index entry—an entry with length=0 and front-key 
compression=0. 


7 Read obtains a copy of the previously written (from 
step 2) sequence-set record. 


IDAOI9RG builds a horizontal pointer entry to allow the 
record to point to the newly created sequence-set record. 


8 IDAER removes the dummy entry from the sequencesett 
record. 


9 IDAWR writes the updated (previous, from step 7) 
sequence-set record into the index. The sequence-set 
record now has the “proper’’ ending entry. 


IDA019RG adjusts the higher-level index records to 
reflect the addition of a new sequence-set record. 


10 When a higher-level index record is required, IDAAQR 
locates the control interval containing it. 


If all allocated space in the data set has been used, 
IDAAQR calls IDAEOVIF to obtain another extent for 
the data set. 


If the newly obtained extent must be preformatted before 
it can be used, IDAAQR calls IDA019RK to preformat it. 


IDA019RG obtains more virtual storage (using 
GETMAIN) for another ICWA, if all other ICWAs are 
being used, and initializes it. 


11 IDAR reads in the higher level index record. 


12 IDAIST builds an index entry to describe the sequence-set 
index record and puts it into the higher level index record. 


13 If the entry won't fit in the higher level record, 
IDAFREEB frees the buffer containing the higher level 
index record (from step 11). 


14 IDAWR writes out the updated higher level index record, 
so that the index is always as current as possible. Steps 10 
through 14 are repeated to update as many levels of the 
index as are required. 


15 INTNEWRC initializes a buffer for the new sequence-set 
index record. index record. 


16 IDAGNEL obtains an empty buffer for the new 
sequence-set index record. 
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Figure 31. Create-Time Sequence-Set Record Processing: 
Write the Record (Closing the Data Set) 
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C 


Notes for Figure 31 


1 


When the user closes the data set after he creates it, 
IDA019RG writes the last sequence-set record into the 
index. 


IDAWR writes the sequence-set record into the index. 
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Figure 32. NonCreate-Time Sequence-Set Record Processing 
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Notes for Figure 32 


1 


IDA019RH builds an index entry and inserts it in the 
proper position in the sequence-set record when a control 
interval is split. 


IDAO19RC searches the compressed index entries in the 
sequence-set record to locate the insert point for the new 
index entry. 


COMPRS performs rear key compression for the newly 
built index entry. 


COMPRS modifies the front and rear key compression of 

index entries in the sequence-set record that might require 
modification as a result of inserting a new compressed key 
entry. 


IDAWRBER writes the updated sequence-set record into 
the sequence-set. 
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Figure 33. Update the Index: Adding to the End of a Key Range or Data Set 
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Notes for Figure 33 


1 


8 
9 


IDAO19RI updates higher level index records when a 
control area is split. If the control area being split is at the 
end of a key range or data set, this figure describes the 
updating sequence. 


ENTKEY locates and extracts the next to last section 
entry from the index record. 


ENTKEY extracts the last section entry from the index 
record. 


IDAFREEB frees the current index record. 


NEWRCRD builds and initializes a new index record. 
index record. 


IDAAQR obtains a RBA value for the new index record. 


If all allocated space in the data set has been used, 
IDAAQR calls IDAEOVIF to obtain another extent for 
the data set. 


If the newly obtained extent must be preformatted before 
it can be used, IDAAQR calls IDA019RK to preformat it. 


IDAGNEL obtains an empty index buffer for the new 
index record. When the record is built, it will be written 
into the index at the RBA obtained by IDAAQR. 


NEWRCRD builds the new index record. 
IWRITE writes the new index record into the index. 


IDAO19RH writes the index record. 


10 IDAFREEB frees the index record’s buffer. 


11 GETSREC obtains the previous sequencesett record. 


12 IDAGRB retrieves the newly written index record. 


GETSREC adjusts the index record, removing the last key 
entry from the record. 


13 IWRITE rewrites the updated index record into the index. 
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Figure 34. Update the Index: Splitting a Control Area (Not at the End of a Key Range or Data Set) 
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Notes for Figure 34 


1 IDAOI19RI updates the higher level index records when a 
control area is split. If the control area being split is not at 
the end of a key range or data set, this figure describes the 
updating sequence. 


2 IDAOQI19RJ splits the current sequencesett record. 


If the sequence-set record could not be split at the 
specified point, steps 3 through 7 adjust the split point so 
that it can be split. 


IDAFREEB frees the index buffer. 


4 GETSREC obtains the sequence-set record from the index 
(IDA019RJ destroyed the old copy during its processing.) 


5 IDAGRB retrieves the sequencesett record. 


FINDSP scans the sequence-set record to locate the split 
point. 


7 LNEXTE adjusts the split point by one entry. Step 2 is 
retried, and steps 3 through 7 repeat, until the 
sequence-set record is split. 


8 IDAOI9RB searches the index to locate the insert point in 
the next higher level of the index. 


9 IDAO19RH inserts the new entry in the higher level index 
record. 


If the entry doesn’t fit in the higher level index record, 
steps 10 and 11 attempt to split it. 


10 FINDSP locates the midpoint of the index record entries 
in the higher level index record. 


11 IDAO19RJ splits the index record. If the split could not be 
made at the specified point, steps 12 through 15 adjust the 
split point so that the record can be split. 


12 IDAFREEB frees the index record’s buffer. 


13 GETSREC obtains the higher level index record from the 
index (IDA019RJ destroyed the copy in the buffer during 
its processing). 


14 IDAGRB retrieves the index record. 


15 LNEXTE adjusts the split point by one entry. step 11 is 
retried, and steps 12 through 15 repeat, until the index 
record is split. When the split is correct, steps 8 and 9 
insert the entry that would not fit before. 


16 IWRITE writes the index record containing.the new entry 
into the index. 


17 IDA019RH writes the index record. 
18 IDAFREEB frees the index record’s buffer. 


19 If a new high-level index record was built by this index 
upgrading processing, IDAEOVIF updates the catalog 
information for the index. 


20 If a new high-level index record is needed, NEWRCRD 
obtains a RBA and buffer for the record. NEWRCRD 
builds the new record and does steps 16 through 19 to 
write the record and adjust the index’s catalog 
information. 


21 IDAAQR obtains a RBA value for the new high-level 
index record. 


If all allocated space in the data set has been used, 
IDAAQR calls IDAEOVIF to obtain another extent for 
the data set. 


If the newly obtained extent must be preformatted before 
it can be used, IDAAQR calls IDA019RK to preformat it. 


22 IDAGNFL obtains an empty index buffer for the new 
index record. When the record is built, it will be written 
into the index at the RBA obtained by IDAAQR. 
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Figure 35. PUT/ERASE Processing 
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Notes for Figure 35 


1 IDAO019R1 is the common Record-Management request 
module. It verifies that the request is valid and checks for 
keyed processing of a relative record data set. 


2 IDAO19RR selects the processing path for GET, PUT, 
POINT, or ERASE and for direct, sequential, or skip 
sequential access. 


Update or Erase 


PUT-update or ERASE requires that a GET-update was 
previously issued. Therefore, the control interval that 
contains the record to be updated or deleted is in the data 
buffer, and the PLH points to the record. 


3 For PUT-update, IDA019RQ lays the updated record over 
the old record. For ERASE, IDA019RQ fills the slot with 
binary zeros and changes the RDF to indicate an empty 
slot. 


4 Fora direct request that is not to have string position 
noted, IDAWRBEFER writes the data buffer to the control 
interval. 


5 IDAFREEB frees the data buffer. 


If the user’s EXLST contains an active journal exit 
address, IDATJXIT provides the necessary journaling 
information for the user’s journal exit routine. 


Insert 


The slot indicated by the search argument or by current 
positioning must be empty. If it isn’t, the record to be 
inserted isn’t inserted, because of duplicate record. 


7 PUTNONSQ locates the control interval for a direct or 
skip sequential request. The search argument (relative 
record number) is converted to the RBA of the control 
interval that contains it and the offset of the record in the 
control interval. 


8 For skip sequential access, IDARRDRL verifies that the 
search argument is greater than the previous one, 
indicated by positioning. It retrieves the control interval 
by RBA and sets the PLH pointer to the indicated slot. 


9 If the indicated relative record number is in a control 
interval beyond the last control interval currently in the 
data set, GETSPACE calls IDA0O19RK to preformat the 
next control area. If processing is for creation (the data set 
was empty when opened) with the SPEED option, the rest 
of the control intervals in the current control area are 
preformatted before a new control area is preformatted. 
Control intervals are preformatted until the one that 
contains the indicated relative record number has been 
preformatted. GETSPACE calls IDAEOVIF when 
additional space is needed for control areas. 


10 To insert the record into a slot in a control interval not 
currently in the data set, no control interval is read. 
IDAGNNEL gets an empty data buffer and formats it 
with empty slots. 


11 PUTSQIST locates the first control interval of the data set 
when the first request after OPEN is sequential. 


12 IDAABF adds additional buffers to the buffer chain for 
read-ahead buffering. 


13 If processing is not for creation (that is, the data set 
contained formatted control areas when opened), 


IDARRDRL retrieves the first control interval and sets 
the PLH pointer to the first slot in the control interval. 


14 If processing is for creation, IDAGNNFL gets an empty 
data buffer and formats it with empty slots. 


NonCreate 


15 PUTSQNCR processes sequential requests when 
processing is not for creation. If the previous request was 
POINT with KGE (key greater than or equal), the control 
interval identified by the search argument of the POINT is 
retrieved. Otherwise, PUTSQNCR advances the PLH 
pointer to the next slot. If there are no more slots in the 
control interval, the next control interval is retrieved. 


16 When additional space is allocated, IDADRQ gets 
exclusive use of the data set for extension. 


17 When the next control interval is in the next control area, 
GETSPACE calls IDA019RK to preformat the next 
control area. If additional space is needed for the next 
control area, GETSPACE calls IDAEOVIF to allocate the 
space and preformat the first control area in it. 


18 When there are no more slots in the current control 
interval, IDAFREEB frees the current data buffer. 


19 IDAGNXT retrieves the next sequential control interval. 


20 If the previous request was POINT with KGE, 
PUTNONSQ retrieves the control interval identified by 
the search argument of the POINT. 


Create 


21 PUTSQCRE processes sequential requests when 
processing is for creation. PUTSQCRE advances the PLH 
pointer to the next slot in the current data buffer. 


22 When the next control interval is in the next control area, 
GETSPACE calls IDA019RK to preformat the next 
control area. If additional space is needed for the next 
control area, GETSPACE calls IDAEOVIF to allocate the 
space. Unless the SPEED option is indicated, IDAEOVIF 
preformats the first control area in the newly allocated 
space. 


23 When there are no more slots in the current control 
interval, IDAFREEB frees the current data buffer. 


24 When the next control interval hasn't been preformatted, 
IDAGNNEL gets an empty data buffer and formats it 
with empty slots. 


25 When the next control interval has been preformatted and 
the RECOVERY option is indicated, IDAGNXT retrieves 
the next control interval and puts it in the data buffer. 


26 When the next control interval has been preformatted and 
the SPEED option is indicated, IDAGRB retrieves the 
next control interval by RBA and puts it in the insert 
buffer. Using the insert buffer causes an update-write 
channel program to be used when the control interval is 
written. 


IDA019RQ moves the record to be inserted into its slot, 
unless the slot already contains a record. The record to be 
inserted is considered a duplicate. 
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Notes for Figure 35 Continued 


27 For a direct request that is not to have string position 
noted, IDAWRBEFR writes the data buffer to the control 
interval. 


28 IDAFREEB frees the data buffer. 


29 For a direct request that is not to have string position 
noted, where the current data buffer is the insert buffer, 
IDASBF writes the insert buffer and removes it from the 
normal buffer chain. 


30 If the user's EXLST contains an active journal exit 
address, IDATJXIT provides the necessary journaling 
information for the user's journal exit routine. 
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Figure 36. Path Processing 


342 OS/VS2 SVS Independent Component: Virtual Storage Access Method (VSAM) Logic 


Notes for Figure 36 


1 


IDA019R1 checks the user’s RPL for validity and assigns a 
PLH to it. It detects a request for access to a base cluster 
by way of an alternate index. 


IDA019RX builds an inner RPL to be used in retrieving 
the alternate-index record needed for the request. 


IDAO19R4 retrieves the alternate-index record needed for 
the request. 


If IDA019R4 detected that the user’s data area was too 
small for the alternate-index record, IDA019RX increases 
the size of the area. 


IDA019RX builds an inner RPL to be used for the request 
for access to the base cluster. 


IDAO019R4 issues the request for access to the base cluster. 


IDA019RX transfers any return code from the inner RPL 
to the user’s RPL. 
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Figure 37. Upgrade Processing 


344 OS/VS2 SVS Independent Component: Virtual Storage Access Method (VSAM) Logic 


Notes for Figure 37 


1 


For a PUT or ERASE, when there is an upgrade table 
(UPT)—which indicates that the base cluster has an 
upgrade set, IDA019R4 calls IDAO19RU for upgrade 
processing. 


For each alternate index in the upgrade set, IDA019RU 
determines whether the PUT or ERASE requires an 
alternate-index record or a pointer in an alternate-index 
record to be added or removed. 


For each alternate index that requires upgrading, 
IDA019R4 does the I/O to accomplish upgrading. 


If each alternate index was upgraded successfully, 
IDAO019R4 does the I/O for the PUT or ERASE. 


If the I/O for the PUT or ERASE failed, IDA019RU 
backs out (undoes) the upgrading for each alternate index. 


For each alternate index whose upgrading was backed out, 
IDA019R4 does the I/O to accomplish backing out. 
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Figure 38 (Part 1 of 3). Buffer Management 
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Notes for Figure 38 (Part 1 of 3) 


1 IDA019RZ is entered for all frequently used Buffer 
Management functions. It sets a code in a register that 
indicates the requested function. For requests without 
shared resources specified, it calls IDA019R2; for requests 
with shared resources specified, it calls IDAOI9RY. Some 
procedures (such as IDAFREEB) are literally part of 
IDA019RZ, but their processing actually takes place in 
IDA019R2 or IDAO19RY. (For example, in this figure, 
IDAFREEB is shown as a procedure of both IDA019R2 
and IDAO19RY.) 


Without Shared Resources 


2 IDAFREEB makes an index or insert buffer available for 
reassignment. For sequential retrieval, when IDAFREEB 
frees a data buffer, it initiates read-ahead buffering if 
enough free buffers are available for it. 


3 For read-ahead buffering, IDAWAIT lets any previously 
started I/O finish. 


4 IDAFRBA determines the RBA of the next control 
interval. 


5 When one or more of the RBAs in the I/O chain are not 
in ascending sequence, IDARVRS1 puts them in 
ascending sequence. 


6 IDA019R3 (I/O Management) issues I/O for read-ahead 
buffering. 


7 IDAWRBER writes the buffer(s) in the current I/O chain. 


8 IDAWAIT lets any previously started I/O finish. 


IDA019R3 (I/O Management) issues I/O for the current 
chain. 


10 IDAWAIT lets the I/O started in step 9 finish. 


11 IDASBF moves buffer(s) from the I/O chain back to the 
buffer pool. 


12 Before IDASBF moves a buffer back to the buffer pool, 
IDAWRBER ensures that no writes are pending against 
the buffer. 


13 IDAWAIT lets any I/O pending against the buffer finish. 
14 IDAGRB reads an index or a data control interval. 
15 IDAWAIT lets any previously started I/O finish. 


16 IDARVRS1 puts in ascending sequence any RBAs in the 
I/O chain that are out of order. 


17 Unless the index or data control interval is already in the 
buffer pool, IDA019R3 (I/O Management) issues I/O to 
read it. 


18 IDAGNFL supplies a work buffer for index processing or 
for a control-interval split. 


19 IDAGNNEFL supplies an empty data buffer for sequential 
output processing. 


20 IDAWAIT lets any previously started I/O finish. 


21 When enough buffers are already flagged for output, 
IDA019R3 (I/O Management) issues I/O to write them. 


22 If the current buffer’s contents have been modified, 
IDAWRBER write it. 


23 IDAWAIT lets any I/O pending against the buffer finish. 


24 IDAGNXT ensures that the next data control interval has 
been read and provides a pointer to the buffer that 
contains it. 


25 IDAWAIT lets any pending I/O finish. 


26 IDA019R3 (I/O Management) issues I/O to read a buffer 
that was not read previously because another request had 
exclusive control of it. 


27 IDAEXCL obtains exclusive control of a control interval 
identified by RBA. 


28 IDAGWSGW obtains an empty data buffer from the 
current I/O chain. 


With Shared Resources 
29 IDAFREEB makes a buffer available for reassignment. 
30 IDAWRBER writes a buffer. 


31 If the user’s EXLST contains an active journal exit 
address, IDATJXIT notifies the journal exit routine of an 
impending write. 


32 IDA019R3 (I/O Management) issues I/O for the write. 
33 IDAWAIT lets I/O for the write finish. 


34 If an I/O error occurred, IDA019RS5 builds an error 
message. 


35 If an I/O error occurred and the AMB contains an 
exception exit address, IDAEXEX passes control to the 
exception exit routine. 


36 If an I/O error occurred and the user’s EXLST contains 
an active journal exit address, IDATJXIT passes control 
to the journal exit routine. 


37 IDASBF frees the current buffer. 


38 If the buffer’s contents have been modified, IDAWRBFR 
writes it. 
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Figure 38 (Part 2 of 3). Buffer Management 
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Notes for Figure 38 (Part 2 of 3) 
39 IDAGRB reads an index or a data control interval. 


40 If the buffer is already being read, IDADRQ suspends 
processing for the current request. 


41 Unless the index or data control interval is already in the 
buffer pool, READBFR reads it. 


42 IDA019R3 (I/O Management) issues I/O for the read. 
43 IDAWAIT lets the I/O started in step 42 finish. 


44 If an I/O error occurred, IDA019R5 builds an error 
message. 


45 If an I/O error occurred and the user's EXLST contains 
an active journal exit address, IDATJXIT passes control 
to the journal exit routine. 


46 If an I/O error occurred and the AMB contains an 
exception exit address, IDAEXEX passes control to the 
exception exit routine. 


47 IDAGNEFL supplies a work buffer for index processing or 
for a control-interval split. 


48 IDAGNNEL supplies an empty data buffer for sequential 
output processing. 


49 IDAGNXT ensures that the next data control interval has 
been read and provides a pointer to the buffer that 
contains it. 


50 IDAFRBA determines the RBA of the next control 
interval. 


51 IDAGRB obtains the control interval. 


52 IDAWRTBEF processes a WRTBFR macro to write the 
buffer(s) indicated by the caller. 


53 If any of the buffers to be written are being used by 
another request, IDADRQ suspends processing for the 
current request until the other request makes the buffers 
available. 


54 IDAWRBER writes the buffers. 


55 IDASCHBF processes a SCHBFR macro to search the 
buffer pool for the RBA indicated by the user. 


56 If a buffer contains the indicated RBA but is in the process 
of having the control interval read into it, IDADRQ 
suspends processing for the current request until reading is 
finished. 


57 IDAMRKPBF processes a MRKBFR macro to mark a 
buffer to be released or for output. 


58 IDAGWSGW obtains an empty data buffer from the 
current I/O chain. 


59 If the buffer’s contents have been modified, IDAWRBFR 
writes it. 


60 If the RPL specifies synchronous and WAITX, exit to the 
UPAD routine. If the ECB is still not posted for a 
synchronous request, IDAWAIT issues a WAIT macro for 
the I/O to finish. For an asychronous request, IDAWAIT 
sets a flag for the I/O Manager's Asynchronous Routine to 
pass control to IDAWAIT after the I/O is finished. 
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Figure 38 (Part 3 of 3). Buffer Management 
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Notes for Figure 38 (Part 3 of 3) 


61 IDAO19RW receives requests for Buffer Management 
functions that are used only infrequently. 


62 For processing without shared resources, IDAABF adds 
buffers to a string’s I/O chain to shorten processing time. 


63 For processing without shared resources, IDAAIBF adds 
the insert buffer to a string’s I/O chain for a control-area 
split or for updating or inserting a spanned record. 


64 For processing without shared resources, IDAGWSGW 
locates empty buffer(s) in the string’s I/O chain so that a 
spanned record can be inserted or lengthened (with 
additional segments) without using buffers that are being 
used for read-ahead buffering. 


65 IDAWRBER writes empty buffers whose contents have 
been modified. 


66 IDAFRBA determines the RBA of the next control 
interval. 


67 When the next RBA in sequence is in the next control 
area, IDAWRBER prevents subsequent repositioning to a 
preceding control area for writing. 


68 For processing with shared resources, IDAGRB reads the 
index control interval that contains the current 
sequence-set record. 


69 When sequence-set pointers become invalid (because of 
the control-interval split or processing with shared 
resources), IDAQ19RC searches the sequence set for the 
current Key. 


70 For processing without shared resources, IDA019R3 (I/O 
Management) issues I/O to read a sequence-set record. 


71 For processing without shared resources, IDAWAIT lets 
the I/O started in step 70 finish. 


72, When the next RBA in sequence is in the next control 
area, IDAWRBEFER prevents subsequent repositioning toa 
preceding control area for writing. 


73 For backward processing, IDAO19RV obtains the 
sequence-set record preceding the current sequence-set 
record. 


74 For processing with shared resources, IDAGRB obtains 
the next sequence-set record. 


75 For processing without shared resources, IDA019R3 (I/O 
Management) issues I/O to read the next sequence-set 
record. 


76 IDAWAIT lets the I/O started in step 75 finish. 
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Figure 38.1 Checkpoint Processing 
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Notes for Figure 38.1 


1 


IGCO006C and IGCO206C are VS2 Release 1.7 checkpoint 
modules described in OS/VS2 Release 1.7 
Checkpoint/Restart Logic. 


IGC0206C loads and branches to IDAOCO6C to save 
VSAM control block information. 


IGCOQO06C is a VS2 Release 1.7 checkpoint module 
described in OS/VS2 Release 1.7 Checkpoint/Restart 
Logic. It frees the VSAM VCRWA and all VCRT’s if they 
exist. 


IGCOS06C is a VS2 Release 1.7 checkpoint module 
described in OS/VS2 Release 1.7 Checkpoint/Restart 
Logic. 
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Figure 38.2 Restart Processing 
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Notes for Figure 38.2 


1 


IGCOOO5B and IGCOTOSB are VS2 Release 1.7 restart 
modules described in OS/VS2 Release 1.7 
Checkpoint/Restart Logic. 


IGCOAOS5B loads and branches to IDAQAOSB. 


IDAOAOSB is the VSAM restart module. It restores 
VSAM control blocks. 


IDA0192M, the VSAM Virtual Storage Manager, is called 
to acquire storage for PFL’s. 


IDAOBOSB is the VSAM restart module second load. It 
does data set repositioning and/or verification. 


IGCOVOS5B is a VS2 Release 1.7 restart module described 
in OS/VS2 Release 1.7 Checkpoint/Restart Logic. 
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Figure 40. VSAM Catalog Management Processing 
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See Figure 10 
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Notes for Figure 40 


1 


1GC0002F is an OS/VS Catalog Management module (see 
OS/VS Catalog Management Logic for details). 


IGGOCLAI is the VSAM Catalog Management transient 
load module. 


IGGOCLC9 builds the CCA for the request and performs 
initial and final VSAM Catalog Management processing. 


IGGPACDV is the VSAM Catalog Management Common 
Processing procedure. 


When the VSAM master catalog is not open, IGGPMCO 
is called to open it. 


IGGPMCO and IGGPMC0O2 initialize an ACB to 
describe the VSAM master catalog, then issue SVC 19 to 
open it. 


When the CTGPL indicates a VSAM Catalog 
Management Services request (DEFINE, ALTER, 
DELETE, or LISTCAT), the VSAM Catalog 
Management Services: Common Processing procedure 
(IGGPCDVR) is called. 


IGGPSCNC checks and initializes the CTGFLs for the 
other types of Catalog Management requests (LOCATE 
and UPDATE). 


IGGPSCAT retrieves the catalog record identified by the 
CTGPL (the VSAM object’s base catalog record). 
Extensions to the base record are retrieved as they are 
needed. 


BI: IGGPGET issues GET to retrieve catalog records. 


10 IGGPCKAU verifies the caller’s authorization to perform 


the CTGPL’s request. 


AZ: IGGPEXT locates the password information required 
by IGGPCKAU. 


BI: IGGPGET issues GET to retrieve the object’s catalog 
record that contains its password set of fields (group 
occurrence). 


11 When the user is on a TSO terminal, IGGPWTSO issues 


requests to the TSO terminal for the required password. 


12 When the caller’s request is UPDATE, IGGPUPD 


receives control. The caller may request that his VSAM 
data set be extended (IGGPUPDE), that it be reset 
(IGGPRUS), or it be updated (IGGPUPD). If the request 
is for an update, only fixed-length record fields should be 
changed. 


13 When the caller’s request is SUPERLOCATE, 


IGGPSLOC processes it. SUPERLOCATE obtains the 
volume serial number of each volume that contains a part 
of the cluster’s data set and index. 


AZ: IGGPEXT locates the volume information sets of 
fields (group occurrences). 


BI: IGGPGET issues GET to retrieve catalog records as 
required. 


14 The caller's GENDSP request is processed by either 


IGGPGDSP (request for a nonunique data space) or 
IGGPGUDS (request for a unique data space). GENDSP 
obtains the control interval members of the catalog 
record(s) of each object (cluster, data set, index, and 
catalog) contained in a VSAM space identified by a 
DSNAME. 


AZ: IGGPEXT locates the data space group set of fields 
(group occurrence) that describes the data space and the 
data set directory entry sets of fields that point to the 
catalog records of VSAM objects in the volume’s data 
space. 


BI: IGGPGET issues GET to retrieve volume catalog 
records as required. 


15 When the caller’s request is LOCATE, IGGPLOC 


processes it. The caller is allowed to retrieve fixed-length 
and (entire) variable-length catalog record fields. 


16 When the caller’s request is LSPACE, IGGPLSP processes 


it. 


AZ: IGGPEXT locates the data space group sets of fields 
(group occurrences) that describe each shared 
(nonunique) data space on the volume. 


BI: IGGPGET issues GET to retrieve volume catalog 
records as required. 


BV: IGGPSMFL writes SMF record type 69—VSAM 
Data Space Defined or Deleted. 
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Figure 41. LOCATE/Extract Processing 
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Notes for Figure 41 


1 


9 


IGGPLOC retrieves an entire (fixed-length or 
variable-length) catalog record field’s contents for the 
caller (other than an internal OS/VS2 catalog 
management procedure). 


IGGPEXT retrieves a fixed-length, variable-length, or 
part of a variable-length catalog record field’s contents for 
the caller (other than an OS/VS2 catalog management 
procedure). 


If the specified filed name indicates a “‘derived 
information” field, IGGOCLBS processes the field name. 


IGGPSCNC initializes CTGFLs with dictionary 
information required to find the field in the catalog record 
and ensures that the CTGFLs are valid. 


IGGPSCNF (steps 6 through 13) processes each CTFGL 
addressed by the caller’s CTGPL to retrieve all catalog 
information that satisfies the caller’s request. 


B3: IGGPSMFG makes a copy of the base catalog record 
in case it is updated later by a modify call. 


IGGPUPGD retrieves the associated upgrade entry record 
if this is an upgrade field name. 


BA: IGGPGVAL retrieves the connecting association to 
the upgrade entry from the current base entry. 


BI: IGGPGET issues GET to retrieve connecting entries 
to the upgrade entry, as well as the upgrade entry itself. 


When the CTGFL (addressed by the caller’s CTGPL) 

addresses CTGFLs-for-tests, IGGPTSTS (steps 6 through 
10) processes each CTGFL-for-tests to identify each set of 
fields (group occurrence) that satisfies the test conditions. 


IGGPGVAL retrieves one catalog-record-field’s value. 


If the specified filed name indicates a ‘derived 
information” field, IGGOCLB5 processes the field name. 


If more set of fields pointers (group occurrence pointers) 
are in an extension of the base catalog record, or 


If the specified set of fields pointer (group occurrence 
pointer) contains the control interval number of an 
extension record: 


IGGPGREC retrieves the required extension record. 
BI: IGGPGET issues GET to retrieve the catalog record. 


B3: IGGPSMFG makes a copy of the catalog record in 
case it is updated later. 


IGGPLVAL locates the field within the catalog record. 


10 IGGPCKLC verifies that the field exists (ie. the requested 


field is in the catalog record or one of its sets of fields 
(group occurrences)). 


11 IGGPTCMP compares the catalog record field’s value to 


the caller’s test data and, if the compare is OK, saves the 
sequence number of the catalog-record-field’s set of fields 
pointer (group occurrence pointer). 


12 IGGPLOC2 retrieves catalog-record-field contents to 


satisfy the caller’s request. If the caller’s CTGFL specifies 
a special field (one not in the catalog record) ora 
combination field-name (a field-name that identifies a 
group of related fields), IGGPLOC2 processes the 
field-name and calls IGGPGVAL, as required, to retrieve 
the requested information. 


If the caller provided CTGFLs-for-tests, each catalog 
record field is retrieved if it is: 


e Identified by the CTGFL’s (addressed by the CTGPL) 
field name, and 


« Contained in a set of fields (group occurrence) that 
satisfies all tests associated with the CTGFL 
(addressed by the CTGPL). The set of fields pointer’s 
(group occurrence pointer’s) sequence number is set by 
step 11. 


If the caller didn’t provide CTGFLs-for-tests, the contents 
of each catalog record field identified by the CTGFL’s 
field name is retrieved. 


13 IGGPGVAL retrieves each catalog-record-field’s 


contents, as required by IGGPLOC2Z. 


14 IGGPSHIN places the catalog record field’s contents into 


the user-provided work area addressed by CTGPL and 
increments the required work area length. If there is 
insufficient space in the work area, only the required work 
area length is changed. 


15 IGGPGREC retrieves the original base catalog record, if 


necessary, since a horizontal extension of the base or an 
associated upgrade entry record may have overlaid it. 
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Notes for Figure 42 


1 IGGPUPD modifies a fixed-length catalog record field, 
obtains more space for a VSAM object, or calls IGGPRUS 
to reset a VSAM data set. 


IGGPUPDE obtains more space for a VSAM object. 
IGGPRUS resets a VSAM data set. 


4 IGGPSFPL (steps 4 through 10 ) processes each CTGFL 
addressed by the caller’s CTGPL to modify all catalog 
record field data specified by the caller’s request. 


5 When the CTGFL (addressed by the CTGPL) addresses 
CTGFLs-for-tests, IGGPTSTS (steps 6 through 10) 
processes each CTGFL-for-tests to identify each set of 
fields (group occurrence) that satisfies the test conditions. 


6 IGGPGVAL retrieves one catalog-record-field’s value. 


If the specified field name indicates a “‘derived 
information” field, IGGOCLBS processes the field. 


7 If more set of fields pointers (group occurrence pointers) 
are in an extension of the base catalog record, or 


If the specified set of fields pointer (group occurrence 
pointer) contains the control interval number of an 
extension record, 


IGGPGREC retrieves the required extension record. 
BI: IGGPGET issues GET to retrieve the catalog record. 


B3: IGGPSMFG makes a copy of the catalog record in 
case it is updated later. 


8 IGGPPREC writes the contents of the buffer (a catalog 
record) prior to reading another record into it, if the 
““buffer-must-be-written”’ indicator is on. 


AG: IGGPPUPC issues PUT-update to rewrite an updated 
catalog record. 


AG: IGGPPAD issues PUT-Add to insert a new catalog 
record into the catalog. 


B3: IGGPSMF identifies the copy of the original catalog 
record (saved by IGGPSMFG) as an updated record. 


Note: When the catalog record is completely updated, a 
SMF record type 63—-VSAM Data Set Cataloged—is 
written that contains the entire new catalog record (the 
base and all extensions) and each part of the original 
catalog record that was modified (part=logical catalog 
record=505-byte (or less) base or extension record’s 
contents). 


9 IGGPLVAL locates the field within the catalog record. 


10 IGGPCKLC verifies that the field exists (that is, the 
requested field is in the record or one of its sets of fields 
(group occurrences)). 


11 IGGPTCMP compares the catalog record field’s value to 
the caller’s test data and, if the compare is OK, saves the 
sequence number of the catalog-record-field’s set of fields 
pointer (group occurrence pointer). 


12 IGGPXLT72 filters those field names (derived) which do 
not exist physically in the catalog. It ensures that these 
fields are not updated; all others are passed to 
IGGPALT72. 


13 IGGPALT72 replaces a catalog record field’s contents with 


the caller’s update data. 


If the caller provided CTGFLs-for-tests, each catalog 
record field is updated if it is: 


« Identified by the CTGFL’s (addressed by the CTGPL) 
field name, and 


« Contained ina set of fields (group occurrence) that 
satisfies all tests associated with the CTGFL 
(addressed by the CTGPL). The set of fields pointer’s 
(group occurrence pointer’s) sequence number is 
available from step 11. 


If the caller didn’t provide CTGFLs-for-tests, each set of 
field’s field identified by the CTGFL’s field name is 
updated. 


14 IGGPMOD allows a VSAM catalog management 


procedure to update catalog record information in the 
following ways: 


A new set of fields (group occurrence) is added to the 
record (IGGPXDGO processing). 


A set of fields (group occurrence) is removed from the 
catalog record (IGGPXEL2 processing). 


A fixed-length field, variable-length field, or part of a 
variable-length catalog record field’s contents is modified 
(IGGPXLT2 processing). 


15 IGGPSCNC initializes the CTGFLs with dictionary 


information required to find the field in the catalog record 
and ensures that the CTGFLs are valid. 


IGGPXDGO intercepts field names (derived) 
which do not exist physically in the catalog. All others are 
passed to IGGPADGO. It constructs a bit map set of 
fields when the first data space group is added and updates 
the associated data space group when data space 
descriptors are added. Note that derived field names exist 
only in the volume entry record. 


AG: IGGPAOCI obtains a control interval for 
constructing the bit map set of fields in an extension 
record. 


AG: IGGPPAD adds the newly constructed bit map 
record. 


AW: IGGPPREC updates the base volume entry record 
which points to the bit map set of fields. 


BA: IGGPGVAL retrieves the data space group 
associated with the space descriptor group to be added. 


BA: IGGPGREC retrieves the base volume entry record 
so that bit map processing can be done. 


BR: IGGPBMR updates the bit map to reflect the added 
space. 


17 When the caller provides set of fields (group occurrence) 


field data, but doesn’t provide CTGFLs-for-tests, 
IGGPADGO builds a new set of fields (group occurrence) 
with the caller’s field data and adds it to the catalog 
record. 


18 IGGPXLT72 filters those field names (derived) which do 


not exist physically in the catalog. It ensures that these 
fields are not updated; all others are passed to 
IGGPALT72. 
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Notes for Figure 42 Continued 
19 When the caller provides header-field field data, or when 


the caller provides set of fields (group occurrence) field 
data and CTGFLs-for-tests, IGGPALT2 modifies the 
field’s contents (as per step 13 above) and makes all 
necessary adjustments to the catalog records. 


20 IGGPXEL2 causes the bit map set of fields to be updated 


when a data space group is to be deleted. All set-of-field 
names, both derived and nonderived, are passed to 
IGGPDEL2. 


BA: IGGPGVAL retrieves the data space group to be 
deleted. 


BA: IGGPGREC retrieves the base volume entry record 
so bit map processing can be done. 


BR: IGGPBMR updates the bit map to reflect the released 
space. 


21 When the caller doesn’t provide field data, IGGPDEL2 


deletes catalog record sets of fields (group occurrences). 


If the caller provides CTGFLs-for-tests, all sets of fields 
(group occurrences) identified by IGGPTSTS (see step 10) 
are deleted. 


If the caller didn’t provide CTGFLs-for-tests, only those 
sets of fields (group occurrences) that contain the field 
identified by the CTGFL’s (addressed by the CTGPL) 
field name are deleted. 


22 IGGPGREC retrieves the original base catalog record for 


processing the next CTGFL, since a horizontal extension 
record may have overlaid it. 


BI: IGGPGET issues GET to retrieve the catalog record. 


B3 IGGPSMFG makes a copy of the catalog record in 
case it is updated later. 


23 IGGPPREC flushes any catalog buffers that must be 


written. 
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Notes for Figure 43 
1 IGGPUPDE obtains more space for the VSAM object. 


BV: IGGPSMFA writes SMF record type 63—-VSAM 
Data Set Cataloged or Altered—for the data set catalog 
record. 


BV: IGGPSMFL writes SMF record type 69—VSAM 
Data Space Defined, Extended, or Deleted—if additional 
space was obtained by DADSM,, either to create a new 
VSAM data space or to extend an existing VSAM data 
space. 


IGGPINIT initializes a CTGPL and CTGFLs and calls 
IGGPEXT. 


AZ: IGGPEXT retrieves the AMDSB set of fields. 


IGGPGET retrieves the base index record for 
key-sequenced data sets that have sequence set with data. 


IGGPEXT retrieves the index AMDSB for key-sequenced 
data sets that have sequence set with data to ensure that 
the maximum number of extents for the index component 
will not be exceeded. 


IGGPSVOL finds the volume information set of fields 
that describes the volume that contains the VSAM object 
to be extended. 


AZ: IGGPEXT locates the volume information set of 
fields. 


When the object is in a non-shared (unique) data space, 
the object is allowed to reside in only one data space (16 
extents maximum) per volume. 


If the data space exists and contains less than 12 extents, 
IGGPUALL calls IGGPSPAC to obtain another extent(s) 
for the data space. IGGPSPAC will return a maximum of 
5 extents to satisfy the request. 


If the data space already contains 16 extents, no space is 
allocated to the object from the specified volume. 


If the data space doesn’t exist (the volume is a candidate 
volume for the object), IGGPUALL calls IGGPSPAC to 
build a data space on the volume for the object. 


AG: IGGPGET issues GET to retrieve the volume catalog 
record. 


IGGPSPAC calls OS/VS DADSM to obtain space for a 
VSAM data space (EXTEND) or to create a new VSAM 
data space (ALLOCATE). 


AG: IGGPISCI ensures that a catalog or CRA extend will 
not occur while the catalog volume entry is being 
modified. 


AG: IGGPPUPC updates the base catalog volume entry 
record after the new timestamp value has been set in it. 


AV: IGGPMOD updates the volume catalog record fields. 
AZ: IGGPEXT retrieves volume catalog record fields. 


BU: IGGPF4DQ, IGGPF4RD, and IGGPF4WR update 
the physical volume’s format-4 DSCB with new timestamp 
values. 


When the object is in a shared (nonunique) data space, the | 
object is allowed to reside in many data spaces (123 
extents maximum per volume). Note: An extent for an 
object in a shared data space is a contiguous amount of 
tracks in one of the data space’s extents (obtained by 
OS/VS DADSM). 


IGGPCSAL attempts to obtain more space for the object 
from any shared data space on the volume. 


IGGPSALL calls IGGPSALS to attempt to obtain the 
required amount of space from the free space of one of the 
shared (nonunique) data spaces on the volume. 


Note: All of the requested amount of space can be 
obtained from more than one shared (nonunique) data 
space. If the amount of space necessary to satisfy the 
request is not contiguous, IGGPSALS obtains (a 
maximum of five) contiguous amounts of tracks to satisfy 
the request. 


10 When all shared (nonunique) data spaces on the volume 


11 


have been examined, and none can satisfy the request, 
IGGPSPAC attempts to obtain another extent(s), at least 
large enough to satisfy the request, for any shared 
(nonunique) data space. If all shared data spaces have 12 
or more extents, IGGPSPAC builds a new data space on 
the volume (if the volume contains enough contiguous free 
space to satisfy a data space’s primary allocation 
requirements). If IGGPCSAL called IGGPSPAC to obtain 
more space from OS/VS DADSM, IGGPCSAL calls 
IGGPSALL again to suballocate part of the newly 
obtained space to the object. 


IPPGTNXO computes the sum of the beginning CCHHs 
(converted to relative track numbers) for the newly 
acquired extents (recoverable catalogs only). 


12 IGGPTXO updates the data set directory with the new 


sum computed in step 11. 


13 IGGPMVOL updates the volume information set of fields 


to describe the object’s newly obtained space. 


AV: IGGPMOD modifies the volume information set of 
field’s fixed-length fields and to modify statistical 
information in the AMDSB. 


14 IGGPCEXT builds extent descriptors to insert in the 


volume information set of fields. The extent descriptors 
describe each contiguous amount of newly allocated 
space. IGGPCEXT computes the RBAs and CCHH values 
from the information returned by IGGPSALL: 


CCHH NN Desc# 
where: 


CCHH is the starting cylinder and track number of the 
extent, 


NN is the number of tracks in the extent, and 


Desc# is the data space descriptor’s sequence number. 
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Notes for Figure 43 Continued 


15 IGGPMEXT inserts the extent descriptors into the volume 
information set of fields. 


Cc AV: IGGPMOD adds the extent descriptor(s) to the 
volume information set of fields (group occurrence). 


16 When the space is obtained for a sequence-set-with-data 
object (a data set or key range), IGGPSSWD allocates 
part of the newly obtained space to the object’s sequence 
set and modifies the object’s index catalog records to 
reflect this. 


Initial IGGPSSWD processing: 


IGGPGET retrieves the index catalog record. The index 
entry is then processed in a manner similar to the data 
entry except that space has already been acquired (hence, 
neither IGGPUALL nor IGGPCSAL is called). 


BV: IGGPSMFA writes SMF record type 63—VSAM 
Data Set Cataloged or Altered—for the index catalog 
record. 
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Notes for Figure 44 


This figure describes the processing done when a caller wants 
to reset (reuse) a VSAM data set. The reusable attribute may 
be applied to a VSAM key-sequenced, entry-sequenced, and 
relative record data set, and to an alternate index. The 
attribute allows the data set to have its high-used RBA set to 0 
at OPEN time. Reusable data sets may be multi-volumed and 
they must be suballocated (nonunique). Also, they cannot 
have key ranges and they are restricted to a maximum of 16 
physical extents per volume. A reusable base cluster may not 
have alternate indexes; however, reusable alternate indexes 
can be associated with a nonreusable base cluster. 


1 IGGPRUS checks the data set catalog record to verify that 
it is a type D record and that the data set has the correct 
attributes for resetting. Appropriate error codes are 
returned to the caller if data set does not have the proper 
attributes. 


2 If the data set is not reusable (but is empty), IGGPRUS 
calls IGGPLOC before returning to caller. No error codes 
are returned. 


3 If the data set can be reset, IGGPEXT retrieves the 
AMDSS set of fields. If the data set attributes in the 
AMDSSB indicate a key-sequenced data set, the user's work 
area (CTGWKA) is checked to ensure that it contains the 
control interval number of the index record in the catalog. 
If not, return to caller with the appropriate error code. 


4 IGGPEXT retrieves each volume information set of fields 
pertaining to the data set. 


5 IGGPGET retrieves the corresponding volume records 
from the catalog. 


6 Each volume information set of fields is updated so as to 
retain only primary extents. If no primary extents remain 
after updating, the volume becomes a candidate volume. 
IGGPMOD returns the updated volume information set of 
fields to the catalog. 


7 If a recoverable catalog is involved, IGGPTNXO 
calculates for each volume processed the sum of the 
relative track addresses of extents remaining in the reset 
data set. 


8 IGGPIXO uses the value from step 7 to update the Data 
Set Directory set of fields for each volume processed. 


9 If the resetting of the data set results in extents being freed 
on the volume being processed, IGGPSSCR updates the 
Space Map set of fields. 


10 IGPMOD updates the catalog with the AMDSB set of 
fields and the base data set catalog record. 


11 If a key-sequenced data set is being reset, IGGPGET 
retrieves the index catalog record and resetting of the 
index section of the data set proceeds as described above 
for the data component. 


12 If a key-sequenced data set has been reset, IGGPFRWK 
retrieves the data set catalog record required by 
IGGPLOC. 


13 IGGPLOC processes the user's LOCATE request. 
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Notes for Figure 45 
1 IGGPADGO inserts a new set of fields (group occurrence) 


into the object’s catalog record and adjusts other catalog 
records as required. In the notes for this figure, the 
hypothetical set of fields to be added is called ADDSET. 


Note: If ADDSET can fit in the base catalog record, its set 
of fields pointer (group occurrence pointer) in the base 
catalog record contains ADDSET’s displacement from the 
beginning of the base catalog record’s sets of fields (group 
occurrences). 


Otherwise, ADDSET is put in an extension record and 
two set of fields pointers (group occurrence pointers) are 
used to locate it. Its set of fields pointer in the base catalog 
record contains the extension record’s control interval 
number. ADDSET'’s set of fields pointer in the extension 
record contains its displacement from the beginning of the 
extension records sets of fields. 


If the base catalog record doesn’t contain an 
‘*available-space pointer”’ (a pointer to an extension 
record that contains free space), IGGPASPT builds an 
‘“available-space pointer”’ (a set of fields pointer with 
sequence number = 0 and type code = 0) and calls 
IGGPIGOP to insert it into the base catalog record. 


IGGPAGOP ensures that there is a set of fields pointer 
(group occurrence pointer) in the base catalog record for 
ADDSET and determines where the set of fields can be 
inserted. If the base catalog record (or one of its 
extensions) contains a deleted set of fields pointer (with 
the same type code as ADDSET), IGGPAGOP activates 
it and assigns it to ADDSET. If not, IGGPAGOP builds a 
set of fields pointer and inserts it into the base catalog 
record (or one of its extensions). 


IGGPGREL identifies the set of fields pointer (group 
occurrence pointer) in the base catalog record (or one of 
its extensions) that has the same type code as ADDSET 
and either: 


e Is marked as deleted, or 


e Has the highest sequence number with ADDSET’s 
group code. 


BA: IGGPGREC retrieves any horizontal extensions of 
the base entry record. 


IGGPAGOPFP then ensures that the base catalog record 
contains a set of fields pointer (group occurrence pointer) 
that will point to ADDSET: 


If IGGPGREL found a set of fields pointer (group 
occurrence pointer) marked deleted which points to an 
extension record: 


5 IGGPIGOP activates the set of fields pointer. 
IGGPAGOP is finished; ADDSET is to be inserted 
into the extension record pointed to by the set of fields 
pointer. 


If ADDSET and its set of fields pointer (group occurrence 
pointer) can fit in the base catalog record: 


6 IGGPIGOP builds a set of fields pointer for ADDSET 
and inserts it into the base catalog record following the 
set of fields pointer identified by IGGPGREL (see 
step 10). IGGPAGOP is finished; ADDSET is to be 
inserted into the base catalog record. 


C If the base catalog record cannot contain a new set of 


fields pointer (group occurrence pointer), even if all sets 
of fields are moved out of the base catalog record: 


7 IGGPAXCI and IGGPGNEX obtain an extension 
record for the base catalog catalog record. 


If the record area in which the extension record is to be 
built already contains a record to be written, 
IGGPGREC flushes the record. 


8 IGGPASPT builds an available space pointer and 
inserts it into the base catalog record’s extension. 


9 IGGPIGOP builds a set of fields pointer for ADDSET 
and inserts it into the base catalog record’s newly 
obtained extension record. IGGPAGOP is finished; 
ADDSET is to be inserted into the base catalog 
record’s newly obtained extension. 


If the base catalog record can contain a new set of fields 
pointer (group occurrence pointer) by moving the sets of 
fields (group occurrences) in the base catalog record into 
an extension record: 


Move the set of fields out of the base catalog record into 
an extension record and adjust the base catalog record as 
necessary: 


10 If the base catalog record’s available-space pointer 
doesn’t point to an extension record, IGGPAXCI and 
IGGPGNEX obtain an extension record to contain the 
sets of fields. 


1 


Le) 


If the base catalog record’s available-space pointer 
points to an extension record, IGGPGREC retrieves 
the extension record. 


AW: IGGPPREC writes any record in the record area 
that must be flushed before the extension record can be 
retrieved. 


BI: IGGPGET retrieves the extension record. 


B3: IGGPSMFG ensures that a copy of the original 
extension record exists. 


12 IGGPMGO moves ail sets of fields (except type code 1 
or 2) into the extension record from the base catalog 
record. IGGPMGO adjusts each set of fields pointer in 
the base catalog record to point to the extension record 
containing its set of fields. 


13 If the extension record obtained by step 11 isn’t able to 
contain all of the base record’s sets of fields, 
IGGPAXCI and IGGPGNEX obtain another 
extension record to contain the remaining sets of 
fields. IGGPAGOP updates the base catalog record’s 
available-space pointer to point to the newly obtained 
extension record. 


14 IGGPMGO moves the rest of the base catalog record’s 
sets of fields into the extension record (obtained in 
Step 13). 


15 IGGPGREL re-identifies the set of fields pointer 


(group occurrence pointer) in the base catalog record 
for ADDSET’s use. 


16 IGGPIGOFP activates or builds a new set of fields 
pointer for ADDSET. IGGPAGOP is finished; the 
record into which ADDSET is to be inserted is the last 
extension record obtained by 11 or 13. 
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Notes for Figure 45 Continued 


If ADDSET is not to be added to the base catalog record 
and if the (deleted, now activated) set of fields pointer (see 
step 3) points to an extension extension record: 


17 IGGPGREC retrieves the extension record into which 
ADDSET is to be inserted. (See Figure 42, steps 7 through 
8, for details.) 


18 If ADDSET and its set of fields pointer cannot fit in 
the extension record, IGGPAXCI and IGGPGNEX 
obtain another extension reocrd. 


19 IGGPGREL determines where (in the extension 
record) ADDSET'’s set of fields pointer (group 
occurrence pointer) should be be inserted. 


If ADDSET is not to be added to the base catalog record, 
and if ADDSET'’s set of fields pointer (in the base catalog 
record) doesn’t point to an extension record: 


20 IGGPAXCI and IGGPGNEX obtain an extension 
record to contain ADDSET. 


21 IGGPIGOP builds a new set of fields pointer (group 
occurrence pointer) for ADDSET and inserts it into 
the extension record that will contain ADDSET. 


22 IGGPMVGO moves ADDSET into the record that is 
to contain it. 
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Notes for Figure 46 


1 IGGPALT2 modifies the contents of a catalog record. It 
repeats the following sequence to process each field name 
identified by a combination name. 


2 IGGPGVAL retrieves the field to be modified (See Figure 
42, steps 5 through 10, for details.) 


3 When the field is fixed-length, IGGPALT2 replaces the 
field’s contents with the caller’s update data. 


When the field is variable-length with length change, 
IGGPMVAR replaces the field’s contents with the caller’s 
update data and adjusts other catalog records as required. 


Note: IGGPMVAR can only be used with IGGPMOD callers, 
since IGGPUPD callers do not modify the contents of 
variable-length fields. 


4 When the variable-length field’s new length is less than or 
equal to its old length, IGGPSHNK: 


1. Adjusts the rest of the record so that all the record’s 
free space is contiguous, and increases the amount of 
free space. 


2. Adjusts other set of fields pointers (group occurrence 
pointers) to reflect displacement changes resulting 
from the free space adjustment. 


3. Replaces the catalog record field’s contents with the 
caller’s update data. 


5 When the variable-length field’s new length is greater than 
its old length, and when the entire new field’s contents can 
be contained in the catalog record, IGGPEXPD: 


1. Adjusts the rest of the record so that the larger field is 
inserted, and decreases the amount of free space. 


2. Adjusts other set of fields pointers (group occurrence 
pointers) to reflect displacement changes resulting 
from the insertion. 


3. Replaces the catalog record field’s contents with the 
caller’s update data. 


When the entire field’s new contents cannot be contained in 
the catalog record, and that record is the base catalog record: 


6 IGGPMBGO moves the field’s set of fields (group 
occurrence) into an extension record. 


7 IGGPGVAL locates the field in the extension reocrd. 


8 If the entire field’s new contents can be contained in the 
extension record, IGGPEXPD updates the field’s contents 
as described in step 5. 


When the entire field’s new contents cannot be contained in 
the catalog record; when the record is an extension record; 
and when the extension record contains two or more sets of 
fields (group occurrences): 


9 Sets of fields (group occurrences) are moved out of the 
extension record into another extension record (as 
described in Figure 48) until: 


e The entire field’s new contents can be contained in its 
set of fields’ extension record, or 


¢ The field’s set of fields (group occurrence) is the only 
set of fields in an extension record. 


When the entire field’s new contents cannot be contained in 
the catalog record; when the record is an extension record; 
and when the extension record contains only the field’s (to be 
updated) set of fields (group occurrence): 


10 IGGPDEIN updates the field’s contents and adjusts other 
catalog records as required. 
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Figure 47. Remove a Set of Fields (IGGPDEL2 Processing) 
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Notes for Figure 47 


1 IGGPDEL2 removes a set of fields (group occurrence) 
and adjusts other catalog records as required. When 
IGGPXEL2 calls IGGPDEL2, IGGPSFPL has determined 
the sequence number of the set of fields pointer (group 
occurrence pointer) to be deleted. In this figure, the set of 
fields to be deleted is called DELSET. 


2 IGGPSGOP locates DELSET’s set of fields pointer (group 
occurrence pointer) in the base catalog record or one of its 
horizontal extensions. 


When DELSET is in the base catalog record or one of its 
horizontal extensions: 


3 IGGPDGO deletes DELSET. IGGPDEL2 marks its set of 
fields pointer (group occurrence pointer) as deleted and 
zeros its displacement value. DELSET is now deleted; 
IGGPDEL2? is finished and returns to IGGPSFPL. 


When DELSET is in an extension record: 


4 IGGPGREC retrieves the extension record and as many 
of its extensions as required to delete DELSET. (See 
Figure 42, steps 6 through 7, for details.) 


When DELSET is the only set of fields in the extension 
record: 


IGGPDEL2 marks DELSET’s set of fields pointer (group 
occurrence pointer) in the base catalog record as deleted 
and zeros its pointer to the extension record. 


5 IGGPPREC updates the object’s base catalog record. 
catalog record. 


6 IGGPPDE issues PUT-update to rewrite the extension as a 
free catalog control interval. 


B3: IGGPSMF identifies the copy of the original catalog 
record (saved by IGGPSMFG) as an updated record. 


DELSET is now deleted; IGGPDEL2 processes each 
additional vertical extension that contains part of the set 
of fields (using steps 4 through 6) and, when DELSET is 
completely deleted, returns to IGGPSFPL. 


When DELSET is not the only set of fields (group 
occurrence) in the extension record: 


7 IGGPSGOP finds DELSET’s set of fields pointer (group 
occurrence pointer) in the extension record. 


IGGPDGO deletes DELSET in the extension record. 


IGGPDGOP deletes DELSET’s set of fields pointer 
(group occurrence pointer) in the extension record. 


IGGPDEL2 marks DELSET’s set of fields pointer (group 
occurrence pointer) in the base catalog record as deleted, 
and zeros its pointer to the extension record. DELSET is 
now deleted; IGGPDEL2 is finished and returns to 
IGGPSFPL. 


Program Organization 379 


IGGOCLAW 


IGGPADGO 
or 
IGGOCLAX aoe 
1 peat Peciare 
2 IGGPMBGO (Continued) 


IGGPMGO 
(Continued) 


3 IGGOCLAG 
IGGPAXCI 


11 IGGOCLAX 
IGGPDGO 


4 IGGOCLAW 
IGGPGNEX 


5S IGGOCLAW 
IGGPPREC 
AG, B3 


12 IGGOCLAX 
IGGPDGOP 


6 IGGOCLBA 
IGGPGREC 
AG, B3 


5S IGGOCLAW 
IGGPPREC 
AG, B3 


13 IGGOCLAG 
IGGPAXCI 


14 IGGOCLAW 
IGGPGNEX 


4 IGGOCLAW 
IGGPPREC 
7 IGGOCLAX AG, B3 


IGGPMGO 


8 IGGOCLAV 


IGGPSGOP 7 IGGOCLAX 


IGGPMGO 
(See Steps 8 - 12) 


9 IGGOCLAW 
IGGPIGOP 


10 IGGOCLAX 
IGGPCGO 


Figure 48. Move a Set of Fields from a Catalog Record into its Extension 


380 OS/VS2 SVS Independent Component: Virtual Storage Access Method (VSAM) Logic 


Notes for Figure 48 


This figure describes the sequence required to move a set of 
fields (group occurrence) from one record (OLDREC) to 
another (NEWREC). The acronyms ‘““OLDREC” and 
““NEWREC” are introduced to help you understand this 
process; these acronyms do not appear in the VSAM code as 
symbolic names or comments. 


1 IGGPMVAR executes this sequence to move each set of 
fields (group occurrence), except the one that contains the 
expanded variable-length field, from one extension record 
to another. IGGPMVAR moves one set of fields at a time, 
the record’s last set of fields, and returns to its caller. 


2 IGGPMBGO executes this sequence to move the 
expanding set of fields (group occurrence) in the base 
catalog record into an extension record. 


3 When the base catalog record’s available-space pointer 
(identified by type code = 0 and sequence number = 0) is 
zero, IGGPAXCI obtains a free control interval. 


4 IGGPGNEX initializes it as an extension record 
(NEWREC). IGGPGNEX then updates the 
available-space pointer to contain NEWREC’s control 
interval number. 


5 If the “buffer must be written” indicator is on, IGGPREC 
writes the contents of the buffer (a catalog record) prior to 
reading another record into it. 


AG: IGGPPUPC rewrites an updated catalog record. 
AG: IGGPPAD writes a new (extension) catalog record. 


B3: IGGPSMF identifies the copy of the original catalog 
record (saved by IGGPSMFG) as an updated record. 


6 When the base catalog record’s available-space pointer 
points to an extension record with free space, 
IGGPGREC retrieves the extension record (NEWREC). 


AG: IGGPGET issues GET to retrieve the catalog record. 


B3: IGGPSMFG makes a copy of the catalog record in 
case it is updated later. 


7 When there is enough free space in NEWREC to contain 
OLDREC’s set of fields (group occurrence), IGGPMGO 
moves the set of fields (group occurrence) from OLDREC 
to NEWREC. 


8 IGGPSGOP searches NEWREC to locate the position of 
the new set of fields’ pointer (group occurrence pointer). 


9 IGGPIGOP inserts a new set of fields pointer (group 
occurrence pointer) in NEWREC to contain the 
displacement of the new set of fields. 


10 IGGPCGO copies the contents of the set of fields (group 
occurrence) into NEWREC and reduces the amount of 
NEWREC’s free space. 


11 IGGPDGO deletes the set of fields (group occurrence) in 
OLDREC and increases the amount of OLDREC’s free 
space. 


12 If OLDREC is not the base catalog record, IGGPDGOP 
deletes the set of fields pointer (group occurrence pointer) 
in OLDREC. 


13 If the caller in step 1 or 2 determines that NEWREC 
(determined at steps 3 or 5) cannot contain the set of 
fields (group occurrence), another extension record is 
built. IGGPAXCI obtains a free control interval and 
IGGPGNEX initializes it as an extension record 
(NEWREC). The base catalog record’s available-space 
pointer is updated. 
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Notes for Figure 49 


1 


5 


IGGPSALS assigns tracks to a VSAM object that can 
reside in a nonunique data space (a data space that can 
contain more than one VSAM object). 


IGGPEXT retrieves data space group sets of fields from 
the volume catalog record. Each Data Space Group set of 
fields contains one or more (up to 16) extent descriptors 
that describe the data space’s extents. IGGPSALS builds a 
table that contains extent descriptors in the form: 


S#TTNN 
where 


S# is the sequence number of the extent descriptor in 
its data space group set of fields. 


TT is the extent’s starting track number, and is 
converted by another routine to CCHH for a seek 
address. 


NN _ isthe number of tracks in the extent. 


When the extent table is full, or when there are no more 
data space group sets of fields to process, IGGPSALS calls 
IGGPEDS to process each entry in the table. 


IGGPEDS scans the data space extent table to find the 
entry with the smallest TT value. This entry is processed, 
then IGGPEDS scans the table again to find the entry 
with the next higher TT value. All entries in the table are 
found, then processed, from the lowest TT value to the 
highest. 


IGGPBMkR scans the space map set of fields, starting at 
bit position TT and ending at bit position TT+NN-1, 
attempting to find a contiguous amount of unallocated 
tracks large enough to satisfy the minimum allocation unit 
for the request (usually a control interval). 


IGGPBMR returns to IGGPEDS with either a “‘no extent 
found” indicator or a TTNN value. IGGPEDS analyzes 
the TTNN value to determine: 


1. If the extent exactly satisfies the caller’s allocation 
request, no further extent table processing is done. 


2. If the extent is larger than the caller’s allocation 
request, but is smaller than any previously obtained 
extent, the (smaller) extent’s TTNN and its data 
space’s sequence number is saved. Processing the data 
space extent table continues. 


3. If the extent is smaller than the caller’s allocation 
request, its TTNN and data space sequence number is 
put in the “small extent table” if: 


« There are fewer than the maximum number of 
entries in the small extent table (five, or a 
caller-specified maximum less than five), or 


» The extent’s NN value is larger than the smallest 
NN value in the small extent table. Processing the 
data space extent table continues. 


When the data space extent table is partially full, 
IGGPEDS processes each entry as described in steps 3 
and 4. 


IGGPBMR adjusts the bits in the space map set of fields if 
the caller’s allocation request is satisfied with one extent. 


If the caller’s allocation request is satisfied with more than 
one extent, all entries in the small extent table are sorted 
on decreasing NN value, so that space is allocated from 
the least number of extents. IGGPBMR adjusts the bits in 
the space map set of fields for each extent required to 
exactly satisfy the caller’s request. Each bit in the space 
map set of fields identifies a track on the volume as either 
allocated to a VSAM object or unallocated. 
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Figure 50 (Part 1 of 2). VSAM Catalog Management Services Processing 
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Notes for Figure 50 


1 


IGGPCDVR is the VSAM Catalog Management Services: 
Common Processing procedure. 


If the request is to create the VSAM master catalog, 
IGGPDEF processes it. 


IGGPSCAT searches the catalog for a duplicate name (if 

the request is DEFINE), or to retrieve the object’s catalog 
record (if the request is ALTER, DELETE, or LISTCAT). 
If the request is DEFINE SPACE, step 3 is not performed. 


IGGPCKAU verifies the caller’s authorization to perform 
the request. If the request is LISTCAT, step 4 is bypassed. 


AZ: IGGPEXT locates the password information required 
by IGGPCKAU. 


BI: IGGPGET issues GET to retrieve the catalog’s cluster 
catalog record (control interval number 2) to determine if 
the catalog is password protected. If the catalog is not 
password protected, all security verification processing is 
bypassed. 


When the user is on a TSO terminal, IGGPWTSO issues 
requests to the TSO terminal for the required password if 
the password is not supplied with the input parameters 
(part of the Access Method Services job syntax language). 


When the caller’s request is DEFINE NONVSAM, 
IGGPDEFA processes it. 


AG: IGGPAOCI obtains a free control interval to contain 
the nonVSAM catalog record. 


AV: IGGPMOD inserts information into the newly 
created nonVSAM catalog record. 


BV: IGGPSMFA writes SMF record type 63—-VSAM 
Data Set Cataloged. 


When the caller’s request is DEFINE SPACE, 
IGGPDEFS processes it. 


AG: IGGPPAD issues PUT-Add to add records to the 
catalog as required. 


BI: IGGPGET issues GET to retrieve the volume catalog 
record. 


IGGPDTIM obtains time-of-day data. 


IGGPSCAT retrieves the the catalog record identified by 
the CTGPL (the VSAM object’s base catalog record). 
Extensions to the base catalog record are retrieved as they 
are needed. 


BI: IGGPGET issues GET to retrieve catalog records. 


10 IGGPCKAU verifies the caller’s authorization to create a 


VSAM data space. 


AZ: IGGPEXT locates the password information required 
by IGGPCKAU. 


BI: IGGPGET issues GET to retrieve the volume-owner’s 
(a VSAM catalog) catalog record that contains the 
password set of fields (group occurrence). 


11 IGGOCLBU processes the format-4 DSCB, when the 


DEFINE SPACE creates the volume’s first data space: 
IGGPF4RD reads the format-4 DSCB. 


IGGPF4DQ dequeues the volume identified by the 
format-4 DSCB. 


IGGPF4WR writes (or updates, if it exists) the format-4 
DSCB. 


12 IGGPDCRA defines a catalog recovery area on the 


volume when the volume’s first data space is created and 
the owning catalog is recoverable. 


13 When the caller’s request is to create a VSAM cluster or a 


VSAM user’s catalog, IGGPDEF processes it. 


14 When the caller’s request is ALTER, IGGPALT processes 


processes it. 


AG: IGGPPUPC issues PUT-update to rewrite a catalog 
catalog record. 


AG: IGGPPAD issues PUT-Add to insert a catalog record 
into the VSAM catalog. 


AG: IGGPPDE issues PUT-update to rewrite the record 
as a free catalog catalog record. 


AV: IGGPMOD modifies the contents of catalog record 
fields. 


AZ: IGGPEXT locates catalog record fields. 
BI: IGGPGET issues GET to retrieve a catalog record. 
BV: IGGPSMFA writes SMF record type 63. 


15 IGGPALVL modifies volume catalog record information. 


AV: IGGPMOD modifies the contents of catalog record 
fields. 


AZ: IGGPEXT locates catalog record fields. 


BI: IGGPGET issues GET to retrieve the volume catalog 
record. 


16 IGGPVRD mounts the required volume(s) and 


IGGPVRCV removes VSAM ownership from the 
volume(s). 


BI: IGGPGET retrieves the volume catalog record. 
BU: IGGPF4RD reads the format-4 DSCB. 


BU: IGGPF4DQ dequeues the volume identified by the 
format-4 DSCB. 


BU: IGGPF4WR writes (updates) the format-4 DSCB. 


17 IGGPALVR updates the volume catalog record. 


AG: IGGPPUPC rewrites the updated volume catalog 
catalog record. 


AV: IGGPMOD modifies fields in the volume catalog 
record. 


AZ: IGGPEXT locates fields in the volume catalog 
record. 


BI: IGGPGET retrieves the volume catalog record. 


18 IGGPSALL assigns a specified volume as a candidate 


volume to a VSAM object. 
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IGGPCDVR 
Continued 


DELETE 
Catalog 


21 IGGOCLAF 
IGGPDELC 
AG, AZ, BI 


22 IGGOCLAL 
IGGPDBVC 


23 IGGOCLAH 
IGGPSCAT 
BI 


24 IGGOCLBU 


DELETE Space 


25 IGGOCLBL 
IGGPDELS 
AV, AZ, BI 


26 IGGOCLBU 


27 IGGOCLBK 
IGGPLSP 
AZ, BI, BV 


28 IGGOCLAI 
IGGPF DSP 


IGGPCDVR 
Continued 


es Se 


DELETE CLUSTER, 
AIX, PATH, or 
NONVASM 


29 IGGOCLBG 
IGGPDEL 
AG 


30 IGGOCLBS 
IGGPDCLS 
AG, AV, AZ, BI, BV 


31 IGGOCLA7 
IGGPVMSC 
AG, AZ, BI 


32 IGGOCLBF 
IGGPSSCR 
AV, AZ 


33 IGGOCLBR 
IGGPCMR 


34 IGGOCLBU 
IGGPF4RD 
IGGPF4DQ 
IGGPF4WR 


35 IGGOCLB8 
IGGPDUND 


36 IGGOCLB1 
IGGPUDEL 


37 IGGOCLA3 
IGGPRPLF 


LISTCAT 


38 IGGOCLBQ 
IGGPLSTC 
AG, AZ 


CONVERTV 


39 IGGOCLBZ 
IGGPCONV 
AG, AH, AV, A3, BU 


Figure 50 (Part 2 of 2). VSAM Catalog Management Services Processing 
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Notes for Figure 50 Continued 


21 When the caller’s request is DELETE CATALOG, 
IGGPDELC processes it. 


AG: IGGPPDE issues PUT-update to rewrite the record 
as a free catalog catalog record. 


AG: IGGPCCCR checkpoints the catalog record before it 
is deleted. 


AG: IGGPRPLF dequeues the catalog (releases exclusive 
control over the catalog so that other requests can process 
its records). 


AZ: IGGPEXT locates catalog record fields. 
BI: IGGPGET issues GET to retrieve the catalog records. 


22 IGGPDBVC verifies that the caller’s work area (to return 
the name of the catalog in) is in the caller’s address space. 


23 IGGPSCAT searches the catalog being deleted to verify 
that the catalog is empty (contains no cataloged objects). 


BI: IGGPGET issues GET to retrieve the catalog records 
that describe the catalog. 


274 IGGOCLBU processes the format-4 DSCB: 
IGGPF4RD reads the format-4 DSCB. 
IGGPF4WR writes the updated format-4 DSCB. 


25 When the caller’s request is DELETE SPACE, 
IGGPDELS processes it. 


AG: IGGPPDEC issues PUT-update to rewrite an 
extension record as a free catalog record. 


AV: IGGPMOD modifies the contents of the volume 
catalog record’s fields. 


AZ: IGGPEXT locates a catalog record field. 


BI: IGGPGET issues GET to retrieve the volume catalog 
record. 


26 If the volume is completely empty, IGGOCLBU processes 
the format-4 DSCB: 


IGGPF4RD reads the format-4 DSCB. 
IGGPF4WR writes the updated format-4 DSCB. 


27 When the volume catalog record is not deleted, IGGPLSP 
determines the amount of available space there is on the 
volume. 


AZ: IGGPEXT locates each shared (nonunique) data 
space group set of fields (group occurrence) in the volume 
catalog record. 


BI: IGGPGET issues GET to retrieve the volume catalog 
record. 


BV: IGGPSMEFL writes SMF record type 69—VSAM 
Data Space Defined or Deleted. 


28 IGGPFDSP scratches all VSAM data space and makes it 
available to the OS/VS system. 


29 When the caller’s request is DELETE CLUSTER, 
ALTERNATE INDEX, PATH, PAGESPACE, or 
NONVSAM, IGGPDEL processes it. 


AZ: IGGPEXT locates a catalog record’s field. 
BI: IGGPGET issues GET to retrieve a catalog record. 


30 IGGOCLBS contains the following DELETE procedures 


that are called by IGGPDEL: 


IGGPDCLS deletes data, index, cluster, and alternate 
index catalog records. 


IGGPDEAX explicitly deletes an alternate index. 


IGGPDIAX implicitly deletes one or more alternate 
indexes. 


IGGPDEPT explicitly deletes a path. 
IGGPDIPT implicitly deletes one or more paths. 
IGGPDUPG deletes upgrade association set of fields. 


Each of the IGGOCLBS’s procedures call the following 
procedures as needed: 


AG: IGGPPDE issues PUT-delete to delete a catalog 
record. 


AV: IGGPMOD modifies the contents of catalog record 
fields. 


AZ: IGGPEXT locates a catalog record field. 
BI: IGGPGET issues GET to read a catalog record. 


BV: IGGPSMFS writes SMF record type 67 to the SMF 
data set. 


31 IGGOCLA7 contains the following DELETE procedures 


that are called by IGGPDEL: 


IGGPVMSC deletes all space information for the object 
in the volume catalog record. 


IGGPDEMV locates the object’s volume information sets 
of fields (group occurrences). 


IGGPDVMV ensures that all required volumes are 
mounted. 


IGGPDUSC returns the data space (issues SCRATCH to 
delete the format-1 identifier DSCB) from the volume’s 
VTOC. 


IGGPMCRA verifies that the primary CRA volume is 
either mounted or mountable. 


IGGPDF4T updates the format-4 DSCB and the volume 
catalog record timestamp. 


Each of IGGOCLA7’s procedures call the following 
procedures as needed: 


AG: IGGPPUPC issues PUT-update to rewrite an updated 
catalog record. 


AV: IGGPMOD modifies the data space group set of 
fields (group occurrences). 


AZ: IGGPEXT locates a catalog record field. 
BI: IGGPGET issues GET to read a catalog record. 
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Notes for Figure 50 Continued 


32 IGGPSSCR returns the space allocated to a catalog or 
cluster that is contained in a shared (nonunique) data 
space. 


AZ: IGGPEXT locates the data space group set of fields 
(group occurrence) that describes the data space. 


AV: IGGPMOD modifies the data space group set of 
fields (group occurrence). 


33 IGGPBMR adjusts the space map set of fields to show the 
newly allocated tracks. 


34 IGGOCLBU contains the following external procedures 
used by the DELETE procedures: 


IGGPF4RD reads a format-4 DSCB from the VTOC. 

IGGPF4DQ issues the VTOC DEQ macro. 

IGGPF4WR writes the format-4 DSCB in the VTOC. 
35 IGGPGUND cleans up extension records. 


AG: IGGPPDEC issues PUT-update to rewrite an 
extension record as a free catalog record. 


36 IGGOCLB1 contains the following external procedure 
used by DELETE procedures: 


IGGPUDEL deletes upgrade association sets of fields 
from the Y catalog record. 


37 IGGOCLA3 contains the following external procedures 
used by DELETE procedures: 


IGGPRPLF releases the serialability of the catalog 
resource after performing the erase process. 


IGGPRPLM acquires the serialability of the catalog 
resource after performing the erase process. 


38 When the caller’s request is LISTCAT, IGGPLSTC 
processes it. IGGPCKAU is called each time a record is 
retrieved, and verifies the user’s authorization to retrieve 
the record. 


AZ: IGGPEXT locates a catalog record field. 
BI: IGGPGET issues GET to retrieve the catalog record. 


39 When the caller's request is CONVERTV, IGGPCONV 
processes it. 


AG: IGGPPUPC writes the catalog record. 


AG: IGGPRCCR updates the catalog control record to 
indicate the next free control interval. 


AH: IGGPSCAT searches the master catalog for the user 
catalog entry. 


AV: IGGPMOD updates device type fields in data and 
index records in the catalog. 


A3: IGGPRPLF releases the master catalog from 
exclusive control. 


BU: IGGPF4RD reads the format-4 DSCB. 


BZ: IGGPGALO gets the catalog record whose volume 
information is to be updated. 


BZ: IGGPVALI checks the validity of the CTGPL and 
CTGFLs. 
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From Figure 50 
IGGPCDVR 


1 IGGOCLAL IGGPDSCB 
IGGPDEF Continued 
AG 


2 IGGOCLAN 
IGGPDSCB 


— a ee ee es ee ee ee 


3 IGGOCLAP 
IGGPOCDA 
AG 


DEFINE Catalog 


4 IGGOCLAS 
IGGPDEFC 
AG, AV 


5 IGGOCLAQ 
IGGPDEFS 
AG 


6 IGGOCLAR 
IGGPSALL 


IGGOCLAU 
IGGPSALS 
(See Figure 49) 


7 IGGOCLAE 
IGGPDCME 
AG, B3 


8 IGGOCLB4 
IGGPDCRA 


9 IGGOCLAD 
IGGPMCO2 


DEFINE Cluster or 
A1LX 


10 IGGOCLB9 
IGGPPAIX 
BI, BM 


Figure 51. DEFINE Processing 


11 IGGOCLBX 
IGGPDSPC 


12 IGGOCLBO 
IGGPDCCO 


13 IGGOCLBY 
IGGPDRSP 


14 IGGOCLAJ 
IGGPDBDI 


15 IGGOCLAR 
IGGPSALL 


IGGOCLAU 
IGGPSALS 
\(See Figure 49) 


16 IGGOCLAQ 
IGGPDEFS 
AG 


17 IGGOCLAK 
IGGPDCMD 
AV, BV 


18 IGGOCLB8 
IGGPDFBO 


19 IGGOCLB9 
IGGPPATH 


20 IGGOCLAG 
IGGPAOCI 


21 [IGGOCLBV 
IGGPSMFA 
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Notes for Figure 51 


1 IGGPDEF verifies user-provided values, propagates 
certain parameters, and generates a dsname for the data 
set and index of a cluster, as necessary. 


2 IGGPDSCB is a continuation of IGGPDEF. 


IGGPDCDA checks the validity of user-supplied 
parameters and determines the default values of other 
required parameters. 


4 IGGPDEFC defines a VSAM master or user catalog. 


IGGPDEFS builds a data space. The data space is 
nonunique (contains parts of more than one VSAM 
object). 


6 IGGPSALL and IGGPSALS assigns part of the data 
space’s tracks to the catalog—a key-sequenced, key-range 
data set. 


7 IGGPDCOC builds a temporary ACB and temporarily 
opens the catalog so that the catalog’s self-describing 
records (control interval numbers 0 through 13) can be 
written. 


8 IGGPDCRA builds a catalog recovery area if the catalog 
is recoverable. 


9 IGGPMCOZ2 opens the VSAM master catalog, if it is being 
defined, after its self-describing records have been written. 


10 IGGPPAIX checks the validity of the user-supplied input 
parameters and the password for the alternate index. 


11 IGGPDSPC determines the physical requirements of the 
cluster—its control interval size, blocksize, and number of 
blocks per track—based on the device that will contain the 
cluster. 


12 IGGPDCCO checks data and index device characteristics. 


13 IGGPDRSP determines the cluster’s space allocation 
quantities. 


14 IGGPDBDI partially builds the catalog records required 
for the data set and index and obtains the primary space 
allocation for the data set and index. 


15 IGGPSALL assigns candidate volumes to the data set and 
index and, if they reside in a nonunique data space 
(contains more than one VSAM object), IGGPSALS 
allocates space from the data space. 


16 IGGPDEFS obtains a unique data space for the data set or 
index. The data space can contain only one VSAM object. 


17 IGGPDCMD completes the catalog record construction. 


AV: IGGPMOD modifies the contents of catalog record 
fields. 


18 If an error occurred during the cluster’s creation, 
IGGPDFBO resets any allocated tracks to an unallocated 
status and rewrites any partially built catalog records as 
free catalog records. 


19 IGGPPATH verifies user-supplied input parameters and 
the password for the path. 


20 IGGPAOCI obtains one catalog control interval to 
contain the path record. 


21 IGGPSMFA writes SMF record type 63 after a VSAM 
path is successfully defined. 
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Catalog Management I/O Functions 


This section contains a detailed explanation of the catalog management I/O 
procedures. 


When a catalog record is retrieved, updated (rewritten), written (added to the J 
catalog), or deleted, one of the following catalog management procedures 
initiates the I/O operation: 


e IGGPGET—Retrieves the catalog record 

« IGGPPUPC—Updates (rewrites) a catalog record 
« IGGPPAD—Adds a record to the catalog 

« IGGPPDE—Deletes a catalog record 

e IGGPRAG—Retrieves a CRA record 

« IGGPRAPU—Updates a CRA record 

e IGGPRAPA—Adds a CRA record 

e IGGPRAPD—Deletes a CRA record 


Before a new catalog record can be written into the catalog, a catalog’s 
control interval is assigned to contain the new record’s information. This 
assignment is made by: 


« IGGPAOCI—assigns more than one contiguous (if possible) control 
intervals to the caller. This function is usually called during a DEFINE 
procedure. 


e IGGPAXCI—assigns one control interval to the caller. This function is 
usually called when an extension record is being built. 


Other catalog management I/O procedures are called by the ) ) 
above-mentioned procedures to perform special functions. 


All catalog and catalog recovery area I/O functions are described in Figures 
51.1-51.19. 
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IGGPGET—catalog record retrieval IGGPGET 


(IGGPGETC) 
e Retrieves the requested control interval and (my) 
( places it into the caller-specified record area. 
e Initializes the RAB (one of six record area blocks 
in the CCA) and its record segment pointers. GET 
from system No Read from 


Normal keyed GET CRA eiaed 
1. IGGPXIO retrieves the true name record, 

using keyed direct GET. 
2. IGGPGET converts the catalog record’s “tse . 

control interval number (in the true name or built 


catalog record) to an RBA. 


3. IGGPXIO retrieves the catalog record’s 
control interval, using addressed direct GET. 


Normal keyed GET-next 


— Same as “normal keyed GET’”’, except that 
“‘key greater than or equal’’ is specified when 
IGGPXIO retrieves the true name catalog 
record. 


Normal GET by control interval number 


1. IGGPGET converts the catalog record’s 
control interval number (specified by the 
caller) to an RBA. 


2. IGGPXIO retrieves the catalog record’s 
control interval, using addressed direct GET. 


f_IGGPXiO J 
Read the 
true-name 

record: 

key GE 


f IGGPXIO | 
Read the 


GET requests issued while a catalog is being opened aque 


record: 


or created key equal 


— When the catalog is being created, IGGPGET 
“retrieves” the record by locating the DEFINE - 
work area that contains the requested record. canttel 


interval 
number to 


— When the catalog is being opened, IGGPGET RBA 
issues EXCP and WAIT to retrieve the 
requested record. 


Issue EXCP 
and WAIT 
to retrieve 
catalog 
record 


Locate the 
record in the 

DEVINE work 
area 


Move the 
record into 
a record 
area 


No GET 
for update 


Retrieve 

catalog 
record: 
for update 


Initialize 
values in 
the RAB 


Retrieve 
catalog 
record: 
read-onl 


Figure 51.1. Retrieve a Catalog Record (IGGPGET) 
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IGGPPUPC—catalog record write (update) 


1. If the RPL used to retrieve the updated record 
has been reused, IGGPTRPL calls IGGPXIO to 
retrieve the catalog record again. This verifies the 
catalog record’s position in the catalog and 
re-establishes the RPL’s GET-for-update status. 


2. IGGPXIO writes the catalog record into the 
catalog, using addressed direct PUT-for-update. 


IGGPPUPC 


IGGPRAPU 
Recoverable es 
catalog Update CRA 
copy of record 


| IGGPTRPL | 


Ensure that 
record status 
is complete 


IGGPXIO 


Rewrite 
the 

updated 
record 


Figure 51.2. Write (Update) a Catalog Record (IGGPPUPC) 
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IGGPPAD—catalog record write (add) 


1. IGGPXIO retrieves the free control interval that 
will be replaced by the new record, to verify the 
control interval’s position in the catalog and to 
re-establish the RPL’s GET-for-update status. 


2. IGGPXIO writes the new catalog record into the 
catalog, using addressed direct PUT-for-update. 


3. If a true name catalog record is required, 
IGGPPAD builds it, then calls IGGPXIO to write 
it into the catalog using keyed direct PUT. 


IGGPPAD 
(IGGPP ADC) 


TIGGPRAPA 
sei xe Add record 
airs 3 to CRA 


GET 
{__IGGPXIO 


Retrieve 
the free 
record 


PUT 


f IGGPXIO. 
Rewrite it 
with the 
new 
record 


ly 

true-name No 
record 

required 


Is 
the CCR 
in virtual 

storage 


| IGGPRCCR | 


Retrieve 


Set switch 
tu update 
and rewrite 
the CCR 


IGGPXIO 


Return 


Figure 51.3. Write (Add) a Catalog Record (IGGPPAD) 
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IGGPPDE—catalog record deletion 


1. If a true name catalog record exists for the record IGGPPDE 
(IGGPPDEC) 


being deleted: <<. 
Entry 


e IGGPXIO retrieves the true name catalog 
record, using keyed direct GET, to establish 
the record’s GET-for-update status. 


¢ IGGPXIO erases the true name record, using Yes 
keyed ERASE. ei micur 


2. If the catalog control record (CCR) is not already 
in a catalog management record area, 
IGGPRCCR retrieves it. therea 


3. If the RPL used to retrieve the record (to be Ss 
deleted) has been reused, IGGPTRPL calls 
IGGPXIO to retrieve the catalog record again to GET 
verify the record’s position in the catalog and to 
re-establish the RPL’s GET-for-update status. Fe 


4. IGGPPDE builds a free catalog record. Its control 
interval number is the same as the record to be eine 
deleted. The control interval number of the free 


[TGGPXIO__] 
catalog record is put into the catalog’s [ = | 
free-control-interval chain. 

5. IGGPXIO deletes the record by replacing it with 


the free catalog record, using addressed direct A 


PUT-for-update. aE CCR NS Ve 
. storage 
6. IGGPCCCR updates and rewrites the catalog 
No 
control record (CCR). 
[IGGPRCCR _ 
Retrieve 
the CCR 
Ensure that 
record status 
is get-updated 
PUT 


Rewrite us 
free 
catalog 
record 


Set switch 
to update & 
rewrite the 
CCR 


Figure 51.4. Delete a Catalog Record (IGGPPDE) 
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IGGPAOCI—assigns contiguous (if possible) 
catalog control intervals to the caller 


1. If the catalog control record (CCR) is not already 
in a catalog management record area, 
IGGPRCCR retrieves it. 


2. IGGPAOCTI assigns the requested number of 
catalog control intervals to the caller. The control 
intervals will be used to contain new catalog 
records (built during a DEFINE process). One of 
the following methods is used (in the order listed) 
to obtain the control intervals: 


A. If enough previously unassigned control 
intervals are available in the catalog’s extent, 
IGGPANCI preformats and assigns the 
requested number of control intervals to the 
caller. 


B. If enough free control intervals (not necessarily 
contiguous) are available, IGGPAOCI removes 
the requested number of control intervals from 
the free control interval chain and assigns them 
to the caller. 


C. IGGPANCI obtains more space (via Catalog 
Extend) for the catalog, then preformats and 
assigns the requested number of control 
intervals to the caller. 


3. IGGPCCCR updates and rewrites the catalog 
control record (CCR). 


IGGPAOCI 


Entry 


Is 
the CCR Yes 
in virtual 
storage 
~, "7 


No 


IGGPRCCR 


Retrieve 
the CCR 


Enough Yes 
unassigned 
Cls 


Are 
there enough 
free C}s 

? 


GET 
IGGPXIO 


Assign the 
free Cls 
to the 
caller 


LGGPANCI 
Pretormat 
and assign 
the CIs to 
the caller 


Figure 51.5. Assign Catalog Control Intervals to the Caller 
(IGGPAOC]I) 
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IGGPAXCI—assigns one catalog control 
interval to be used as an extension record 


1. If the catalog control record (CCR) is not already 
in a catalog management record area, 
IGGPRCCR retrieves it. 


2. IGGPAXCI assigns one control interval to the 
caller. One of the following methods is used (in 
the order listed) to obtain the control interval: 


A. If a free control interval is available, 
IGGPAXCI removes it from the free control 
interval chain and assigns it to the caller. 


B. IGGPANCI preformats and assigns a 
previously unassigned control interval to the 
caller. This might mean that IGGPANCI first 
obtains more space for the catalog (via Catalog 
Extend). 


3. IGGPCCCR updates and rewrites the catalog 
control record (CCR). 
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IGGPANCI 


in virtual 
storage 
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IGGPRCCR 


Retrieve 


the COR 


GGPANCI 


Preformat and 
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to the caller 


IGGPXIO 


Assign 
tree CH to 
the caller 
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catalog 
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extended 
” 


IGGPCCCR 


Update and 
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Figure 51.6. Assign a Catalog Control Interval for an 
Extension Record (IGGPAXCI) 


IGGPCCCR—updates and rewrites the 
catalog control record (CCR) 


1. The CCR is read to establish its set-for-update 
status. 


2. IGGPCCCR updates the CCR control fields to 
reflect the current catalog record usage. 


3. IGGPCCCR calls IGGPXIO to rewrite the CCR, 
using addressed PUT-for-update. 


IGGPCCCR 


IGGPXIO 
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the catalog 
control 
record 


Update 

RBA and 
control fields 
inthe CCR 


IGGPXIO IGGPRCCR 


Rewrite 
the updated 
CCR 


GLI 
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catalog 
control 

record 


Reset the 
“rewrite 
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Figure 51.7. Update and Rewrite the CCR (IGGPCCCR) 
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IGGPXIO—calls VSAM record management 
1. IGGPXIO initializes an RPL. 


2. IGGPXIO issues GET, PUT, or ERASE—a 
VSAM record management request macro 
instruction. 


oe 


. If an error occurs, IGGPXIO exits on error to 
IGGPIORA to convert the RPL error code to an 
appropriate catalog management error code. 
IGGPIORA then returns to the routine that called 
the catalog I/O function that was processing 
when the error occurred. 


IGGPXIO 


Record Ye IGGPIORA 
— (ew) 


Transtate the 
record ngml, 
error code to 
a cutalog mumt. 
error code 


IGGPEMIO 
Write an 
error message 
to the operator 


brror Yes 


IGGPIORA 
detected Aualy ze the 


Figure 51.8. Call VSAM Record Management for Catalog Request (IGGPXIO) 
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IGGPISCI—ensures that there are enough 


free control intervals, so that the catalog 


won't be extended (obtain more space) at the 
same time a volume catalog record is being 


processed 


1. If the catalog control record (CCR) is not already 


in a catalog management record area, 
IGGPRCCR retrieves it. 


2. If there are not sufficient free control intervals 
available, IGGPISCI calls IGGPANCI to obtain 
more space for the catalog (via Catalog Extend). 


IGGPANCI then preformats and assigns a 
previously unassigned control interval to 
IGGPISCI. 


3. IGGPXIO retrieves the control interval to 
extablish its GET-for-update status, using 
addressed GET-for-update. 


4. IGGPXIO rewrites the control interval as a free 


control interval, using addressed PUT-update. 


5. IGGPCCCR updates and rewrites the catalog 
control record (CCR). 
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Figure 51.9. Ensure Availability of Catalog Control Intervals 


(IGGPISCI) 
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IGGPRCCR—-reads the Catalog Control 
Record (CCR) and updates control fields 
and RBAs from information contained 
within the CCR. 


IGGPRCCR 


Retrieve 


Move CCR 
control fields 
to CAXWA 


Indicate 
that CCR 
was read 


Figure 51.10. Read the CCR and Update Control Fields and 
RBAs (IGGPRCCR) 
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IGGPRAPU—CRA record write (update) 
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record 
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Figure 51.11. Write (Update) a CRA Record (IGGPRAPU) 
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IGGPRAPA—CRA record write (add) 
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Figure 51.12. Write (Add) a CRA Record (IGGPRAPA) 
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IGGPRAPD—CRA record delete 
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Figure 51.13. Delete a CRA Record (IGGPRAPD) 
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IGGPRAOR—orient to CRA 
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Figure 51.14. Orient to the CRA (IGGPRAOR) 


406 OS/VS2 SVS Independent Component: Virtual Storage Access Method (VSAM) Logic 


IGGPRAOP—CRA OPEN 


Remove CRA 
from CRA 
CAXWA chain 


CLOSE 
required 


SVC 20 


CRA 
on catalog 
volume 


Yes 


Close the 
CRA 


Indicate that 
DDname and TIO 
search not 

required 


Get storage for 
CRA, ACB. 
CAXWA. and 
ATIOT 


More 
storage 
required 


Build CRA, ACB, 
CAXWA., and 
ATIOT 


Search for 
DDname and 
TIOT entry 


Free CRA, ACB, 
CAXWA, and 
ATIOT storage 


Figure 51.15. Open a CRA (IGGPRAOP) 


Program Organization 407 


IGGPRARA—assign control interval 
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Figure 51.16. Assign Control Interval Numbers to CRA 
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Figure 51.17. Ensure Availability of CRA Control Intervals 
(IGGPRASC) 
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IGGPRAX—CRA I/O function exit routine 
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Figure 51.18. Return from CRA I/O Function (IGGPRAX) 
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IGGPXRIO—calls VSAM record 
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Figure 51.19. Call VSAM Record Management for CRA Request (IGGPXRIO) 
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DIRECTORY 


The directory section contains lists of items and cross-reference information 
related to each item in the list. The lists include: 


e Module Directory 
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e External Procedure Directory 
e Procedure Calls Directory 
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Module Directory 
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entry points), the component to which the module belongs, and the method of 
operation diagrams and program organization compendium figures in which 
the module is referenced. 
The component identifier codes are: 
II ISAM Interface 
CBM _— Control Block Manipulation 
RM Record Management 
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C Close 
EOV End of Volume 
CM Catalog Management 
C/R Checkpoint /Restart 
External Method of Program 
Module Descriptive Procedure Operation Organization 
Name Name Names Component Diagrams Figures 
IDAIIFBF ISAM Interface: FREEDBUF Processing IDAIIFBF II BU2 — 
IDAIIPM1 ISAM Interface: QISAM Load-Mode Processing IDAIIPM1 II BUI — 
IDAIIPM2 ISAM Interface: QISAM Scan-Mode Processing IDAIIPM2 II BU1 — 
IDAIIPM3 ~~ ISAM Interface: BISAM Processing IDAIITPM3 Il BU2 — 
IDAIISM1 ISAM Interface: SYNAD Processing IDAIISM]1 Il BU2 — 
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BJ1 24 
IDAOI9RB Index Search IDA019RB RM BC1, BH1, BH§8, 22, 34 
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BM1 
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28, 32 
IDAREPOS RM — — 
IDAOI9RF  Control-Area Split IDAO19RF RM BH1, BH2, BH3, _—24, 25, 27, 
BH4, BH5 28, 33, 34 
IDAOAOSB _ Restart IDAOA05B C/R AH1, AH2 38.2 
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Modification of Derived Volume Catalog 


Record Information 


Catalog Read/Write Format 4 DSCB 


Catalog SMF Record Build 


Modify: Delete/Insert Processing 
CMS DEFINE: 4th Module 


CMS DEFINE: 5th Module 


Convert Processing 


Define Data and Index Characteristics 


Upgrade Management 


ALTER: Upgrade/Update 
SMF GET/PUT for Alter 


DEFINE CRA 
DEFINE AIX¥/PATH 


TSO Interface for Security 


Reset Reusable Data Set 


External 
Procedure 
Names 


IGGPXDGO 


IGGPXEL2 
IGGPXLT2 
IGGPXMOD 
IGGPF4DQ 
IGGPF4RD 
IGGPF4WR 
IGGPSMFA 


IGGPSMFF 
IGGPSMFL 
IGGPSMFR 
IGGPSMFS 
IGGPDEIN 
IGGPDSPC 
IGGPDSIM 
IGGPDRSP 
IGGPCONV 
IGGPGALO 
IGGPVALI 
IGGPCMKY 
IGGPDCCO 
IGGPUADD 
IGGPUDEL 
IGGPAUPG 
IGGPSMF 
IGGPSMFG 
IGGPDCRA 
IGGPDCLS 
IGGPDEAX 
IGGPDEPT 
IGGPDIAX 
IGGPDIPT 
IGGPDUPG 
IGGPGTSO 
IGGPWTSO 
IGGPINMD 
[GGPSPSC 
IGGPRUS 


Component 


Method of 
Operation 
Diagrams 


DM1 


EM] 


ED2, ED4, EDS, 
EE2 


DKI1 


EB1, EE], EE3 
EJ3, EJ4 
EJ1, EJ3 
EJ1, EJ3 
FJ3, EJ4 
EJ3, EJ4 
EJ3, EJ4 


DD1 


DE], DH1, DIJ3, 
DI4, DIS, DI6 


Program 
Organization 
Figures 


44 
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Module Directory 


External Method of Program 
Module Descriptive Procedure Operation Organization 
Name Name Names Component Diagrams Figures 
IGGOCLB& CMS DEFINE: Space Recovery IGGPCNBO CM — — 
IGGPDFBO CM — 51 
IGGPDUND CM — 50 
IGGOCLB9 VSAM CMS Define IGGPPAIX CM ED3 50 
IGGPPATH CM ED5 50 
IGGOCLCA OS/VS Catalog Request Handler IGGOCLCA CM — — 
IGGOCLCB VSAM Catalog Request Handler IGGOCLCB CM — — 
IGGOCLC9 Catalog First Load IGGOCLC9 CM DBI 40 
IGGOCLDA CRA Services IGGPMODI CM EE3 — 
IGGPRAPV CM — — 
IGGPWCAT CM EE3 — 
IGGPWCRA CM EE3 — 
IGG0102G OS/VS DADSM: Obtain Space For a VSAM I1GG0102G — — — 
Data Space 
IMDUSRF9 IMDPRDMP Format Appendage IMDUSRF9 CM — — 
Module Packaging 
VSAM modules reside in pageable virtual storage. The minimum virtual 
storage that can be specified when VSAM is included in the OS/VS system is 
2048K bytes. If VSAM was specified at system generation, the minimum 
virtual storage must also have been specified. If VSAM was not specified at 
system generation, you must perform system generation to include VSAM in 
the system. 
The following table lists the VSAM load modules and transients that are 
resident in the SVCLIB or LPALIB library; they are loaded into the pageable 
supervisor or link-pack area by nucleus initialization (NIP) at initial program 
load (IPL). 
Name Description VSAM Modules 
Catalog Management 
IGGOCLC9 Catalog Management IGGOCLAA, IGGOCLAB, IGGOCLAC, IGGOCLAD, IGGOCLAE, 
Modules IGGOCLAF, IGGOCLAG, IGGOCLAH, IGGOCLAI, IGGOCLAJ, IGGOCLAK, 


IGGOCLAL, IGGOCLAM, IGGOCLAN, IGGOCLAP, IGGOCLAQ, 
IGGOCLAR, IGGOCLAS, IGGOCLAT, IGGOCLAU, IGGOCLAV, 
IGGOCLAW, IGGOCLAX, IGGOCLAY, IGGOCLAZ, IGGOCLA6, IGGOCLA7, 
IGGOCLA8, IGGOCLBA, IGGOCLBB, IGGOCLBC, IGGOCLBD, IGGOCLBE, 
IGGOCLBF, IGGOCLBG, IGGOCLBH, IGGOCLBI, IGGOCLBJ, IGGOCLBK, 
IGGOCLBL, IGGOCLBM, IGGOCLBN, IGGOCLBO, IGGOCLBP, IGGOCLBQ, 
IGGOCLBR, IGGOCLBS, IGGOCLBT, IGGOCLBU, IGGOCLBV, IGGOCLBW, 
IGGOCLBX, IGGOCLBY, IGGOCLBZ, IGGOCLBO, IGGOCLB1, IGGOCLB2, 
IGGOCLB3, IGGOCLB4, IGGOCLB5, IGGOCLB6, IGGOCLB7, IGGOCLB8, 
IGGOCLB9,IGGOCLC9,IGGOCLC9 


Control Block Manipulation 


IDA019C1 


Control Block Manipulation IDAO019C1 
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Module Packaging 


Name 


Description 


Catalog Management 


Record Management 


IDAO019L1 


IDA019L2 


IDA019RS 
IDAO19RT 
IDA019R6 


IDA019R7 
IDA019R9 


Modules Record Management 


Improved Control-Interval 
Processing 


Spanned Record Data Modify 
Spanned Record Data Insert 


Channel/ Abnormal End 
Appendage 


I/O Asynchronous Routine 


Start I/O Page-Fix Appendage 


ISAM Interface 


IDAIITFBF 
IDAITPM1 
IDAIIPM2 
IDAIIPM3 
IDAIISM 1 


ISAM Interface FREEDBUF 
ISAM Interface QISAM Load 
ISAM Interface QISAM Scan 
ISAM Interface BISAM 
ISAM Interface SYNAD 


Checkpoint/ Restart 


The Checkpoint/Restart modules are packaged with Open/Close/EOV module IDA0192A. 


IDAOCO06C 
IDAOA05B 
IDAOBO5B 


Checkpoint 
First Restart 


Second Restart 


Open/Close/End of Volume 


IDA0192A 


Open/Close/End of Volume 
Modules 


VSAM Transient Routines 


IFG0192A 


IFGO191X 


IFGO191Y 


IFG0200N 


IGCOA05B 


VSAM Open/Close/End of 
Volume Loader 


VSAM Catalog Open ACB 
Processor, Load 1 


VSAM Catalog Open ACB 
Processor, Load 2 


VSAM Catalog Close/End of 
Volume ACB Processor 


VSAM Release 2 
Restart Controller 


VSAM Modules 


IDAO019RA, IDAO19RB, IDAO19RC, IDAOI9SRE, IDAOIORF, IDAO19RG, 
IDA019RH, IDAO19RI, IDAO19RJ, IDAO19RK, IDAO19RL, IDA019RM, 
IDAOIRN, IDA01RO, IDAO19RP, IDA019RQ, IDAOIRR, IDAO19RU, 
IDAO19RV, IDAOIRW, IDA019RX, IDAOI9RY, IDA019RZ, IDAOI9R1, 
IDA019R2, IDA019R3, IDA019R4, IDAO19RS, IDAO19R8, IDAO19SA, 


IDA019SB, IDA019SF 
IDA019S1, IDA019S3 


IDAO19RS 
IDAO19RT 
IDA019R6 


IDAO19R7 
IDA019R9 


IDAIIFBF 
IDAIIPM1 
IDAITPM2 
IDAITPM3 
IDAIISM1 


IDA0C06C 
IDAOA05B 
IDAOBO5B 


IDA0192A, IDA0192B, IDA0192C, IDA0192D, IDA0192F, IDA0192G, 
IDA0192I, IDA0192M, IDA0192P, IDA0192S, IDA0192V, IDA0192W, 
IDA0192Y, IDA0192Z, IDA0200B, IDA0200S, IDA0200T, IDA0231B, 


IDA0231T, IDA0557A 


IFGO192A 


IFG0O191X 


IFGO191Y 


IFG0200N 


IGCOA05B 


The following module is brought from LINKLIB into the user’s job pack area whenever it is linked to or from the user’s program. 


Name 


Description 


IGGOCLAO Show 


Catalog 
Processor 


Catalog Management Module 
IGGOCLAO 
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External Procedure Directory 


Procedure 
Name 


IDAABF 


IDAADSEG 


IDAADVPH 
IDAAIBF 
IDAAQR 


IDACATI11 
IDACAT12 
IDACAT13 
IDACHKKR 
IDADARTV 
IDADRQ 


IDAENDRQ 
IDAEOVIF 


IDAER 


IDAERROR 
IDAEXCL 
IDAEXEX 
IDAEXITR 
IDAFRBA 


IDAFREEB 


IDAGETWS 
IDAGNFL 


IDAGNNFL 


IDAGNXT 
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Module 
Name 


IDA019RW 


IDAOI9RS 


IDAO1I9RV 
IDA019RW 
IDAO019RN 


IDACAT11 
IDACAT 12 
IDACAT13 
IDA019RM 
IDAO19RT 
IDAOI19RS5 


IDAO19RP 
IDAO19R5 


IDA019RN 


IDAO19R5 
IDA019RZ 
IDAO19R5 
IDAO19R5 
IDA019RW 


IDA019RZ 


IDAO1I9RX 
IDA019RZ 


IDAO19RZ 


IDAO19RZ 


The external procedure directory is organized alphabetically by symbolic 
procedure name (external entry point name). It lists the module that contains 


the procedure, the procedure’s descriptive name, and the method of operation 


diagrams and program organization compendium figures in which the 


procedure is referenced. 


Descriptive 
Name 


Buffer Management: Add Buffer to 
Placeholder (PLH) 


Insert a Spanned-Record-Segment Entry 
into a Sequence-Set Record 


Advance Placeholder Backwards 
Add Insert Buffer to Chain 


Split Index Record: Assign RBA to 
the Index Record 


Private (User’s) Catalog Open 
Private (User's) Catalog Close 
Private Catalog Task Termination 
Check Key for Proper Key Range 
Retrieve a Spanned Record 


Data Insert: Defer the Request until 
the Device is Available 


ENDREQ Request 


Data Insert: Interface to the VSAM 
End of Volume Routine 


Index Create: Erase Dummy Entry from 
the Index Record 


Determine Which Exit to Take 
Exclusive Control 

Exit to User Exception Routine 
Exit to User Routine 


Buffer Management: Determine Next RBA for 
Sequential Processing 


Free a Buffer 


Get Working Storage 
Buffer Management: Obtain an Empty Buffer 


Buffer Management: Obtain Next Empty Buffer 


Buffer for the Placeholder 


Buffer Management: Obtain Next Buffer in 
Sequence 


Method of 
Operation 
Diagrams 


BH4 


BH1, BH2 


BD1 


BG3, BG4, BGS, 
BH8, BH9 


BBI 


BC1, BD1 
BP1, BP3, BS1 


BK1, BK2 


BE1, BG2, BN2 
BOI 


BGS5 


BCI, BD1, BGI, 
BGS, BH4, BH5, 
BM1, BN1, BN2, 
BN3, BO], BO2, 
BS2 


BG3, BG4, BH3, 
BH8 


BE1, BF1, BGI, 
BH4, BH5, BN2, 
BO! 


BCI, BD1, BH4, 
BNI, BOI 


Program 
Organization 
Figures 


23, 28, 35, 
38 


24, 25 


21 
38 


29, 30, 33, 
34 


3] 


26, 28, 29, 
34 


30 


38 


22, 38 


20,2122, 
24, 26, 27, 
28, 30, 33, 
34, 35, 38 


29, 30, 33, 
34, 38 


24, 26, 27, 
28, 35, 38 


20, 21, 23, 
28, 35, 38 


J 


J 


External Procedure Directory 

Procedure Module Descriptive 

Name Name Name 

IDAGRB IDA019RZ Buffer Management: Obtain the Buffer that 


IDAGWSEG 


IDAGWSGW 


IDAHLINS 
IDAITFBF 
IDAIIPM1 
IDAITPM2 
IDAIIPM3 
IDAITSM1 
IDAIST 


IDAIVIXB 


IDAJRNSR 


IDAMRKBF 
IDAMVSEG 


IDANEWRD 


IDARELWS 
IDAREPOS 
IDARRDRL 


IDARSTRT 
IDARVRS1 
IDARXBD 
IDAR 
IDASBF 


IDASCHBF 
IDASPACE 


IDASPNPT 


IDATJXIT 


IDAUPXIT 


IDAWAIT 


IDAWR 


IDA019RZ 


IDA019RW 
IDAO19RI 
IDAIIFBF 
IDAITPM1 
IDAITPM2 
IDAIIPM3 
IDAITSM1 
IDA019RG 


IDA019RH 


IDAO19RT 
IDA019RZ 
IDAO19RS 
IDAO19RI 

IDAOI9RX 
IDAOI9RE 
IDAOI9RR 


IDAO19R5 
IDA01I9RV 
IDA019RX 
IDA019RJ 
IDA019RZ 


IDA019RZ 
IDA019RH 


IDA019RT 


IDAO1I9RP 


IDAO19RP 


IDAOI9RZ 


IDAO19RJ 


Contains the Specified RBA 


Get a Work Segment (for Shared 
Resources) 


Get a Work Segment 

Insert Entry into Index-Set Record 

ISAM Interface: FREEDBUF Processing 

ISAM Interface: Load-Mode Processing 

ISAM Interface: QISAM Scan-Mode Processing 
ISAM Interface: BISAM Processing 

ISAM Interface: SYNAD Processing 


Index Create: Insert Entry into Index 
Record 


Index Insert: Invalidate Buffers 
Containing a Copy of the Modified 
Index Record 


Journal a Spanned-Record Segment 
Mark a Buffer 

Move a Segment 

Initialize a New Sequence-Set Record 
Release Working Storage 

Reposition Placeholder 


Direct Record Locate for Relative 
Record 


Restart 

Order Buffers 

Increase Working Buffer Length 
Split Index Record: Read the Record 


Buffer Management: Remove Buffers from 
Placeholder 


Share a Buffer 


Check an Index Record to Ensure 
It Can Be Split 


Make an Index Entry for a Spanned- 
Record Segment 


Control-Interval Request: Take the 
Journal Exit 


Exit to a User Processing Routine 


Buffer Management: Wait for Completion 
Of I/O operations 


Split Index Record: Write the Index 
Record 


Method of 
Operation 
Diagrams 


BCI, BEI, BHI, 
BH3, BH4, BHS, 
BH9,BH10, BJ1, 
BM1, BN], BOI, 


BS1 


BU2 


BG3, BG4, BGS, 


BH9 


BJ1, BOI 


BGS, BH9, BH10 
BE1, BHS, BK1, 


BNI, BN2 


BS3 
BS1, BS3 


BG4, BGS, BH10 


Program 
Organization 
Figures 


21,2223; 
27, 28, 33 
34, 35, 38 


30 


22; 21 295 
35, 38 


38 


20, 21, 23, 
24, 25, 26, 
27, 35, 38 


38 
22, 38 


30, 31 
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External Procedure Directory 


Procedure 
Name 


IDAWRBFR 


IDAWRTBF 
IDAXGPLH 
IDAOA05B 
IDAOBO5B 
IDA0C06C 
IDA019C1 
IDAOI9RA 


IDAO19RB 


IDA019RC 


IDAO19RE 


IDA0O19RF 


IDA019RG 


IDA019RH 


IDAO19RI 


IDAO19RJ 


IDA019RK 


IDAO19RL 


IDA019RM 


IDAOI9RN 
IDA019RO 
IDAOI9RP 

IDA019RQ 
IDAO19RR 
IDAO19RS 

IDAOI9RT 


IDA019RU 


IDA01I9RV 
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Module 
Name 


IDA019RZ 


IDA019RZ 
IDA019RU 
IDAOAOS5B 
IDAOBOSB 
IDAO0CO06C 
IDAOI9CI1 

IDA01I9RA 


IDAOI9RB 


IDA019RC 


IDA019RE 


IDAO19RF 


IDA019RG 


IDA019RH 


IDAO19RI 


IDAOI9RJ 


IDAO1I9RK 


IDAOI9RL 


IDA019RM 


IDAOI9RN 
IDA019RO 
IDAO19RP 

IDAO19RQ 
IDA019RR 
IDAOI9RS 

IDAO19RT 


IDA01I9RU 


IDA019RV 


Descriptive 
Name 


Buffer Management: Write the Buffer 


Write a Buffer 

Get a Placeholder 
Checkpoint/Restart:Restart 
Checkpoint/Restart:Restart load 2 
Checkpoint/Restart:Checkpoint 
Control Block Manipulation 


Direct Record Locate 


Index Search 


Search Compressed Index Block 


Control-Interval Split 


Control-Area Split 


Index Create 


Index Insert 


Index Upgrade 


Split Index Record 


Preformat 


Data Modify 


Data Insert 


Indexing Subroutines 

Verify 

ENDREQ and JRNAD 
Relative Record Subroutines 
Relative Record Driver 
Spanned Record Data Modify 
Spanned Record Data Insert 


Alternate-Index Upgrade Driver 


Locate Previous Sequence-Set Record 


Method of 
Operation 
Diagrams 

BE1, BG2, BH3, 
BH4, BHS, BH8, 
BH9, BK1, BK2, 
BN2, BN3, BOI, 
BO2 


AGI 

CA1, CB1, CB2 
BC1, BE1, BH1, 
BJ1 

BC1, BH1, BH8, 
BJ1, BM1 


BC1, BH1, BH2, 
BH6, BI1, BJ1, 
BM1 


BH1, BH3, BH7 


BH1, BH2, BH3, 
BH4, BHS5 


BGI], BG2, BG3, 
BG4, BGS, BK2 


BH3, BH6, BH7, 
BH8 


BH4, BH5, BH8, 
BH9 


BH4, BH7, BH8, 
BH9 


BG2, BH4, BH8, 
BH9, BK2, BN2, 
BO! 


BHz2, BI1 


BE1, BF1, BH1, 
BH2, BH3 


BMI 

BK1, BK2 
BOI, BO2 
BC1, BD1, BJ1 
BH2, BI1 


BE1, BF1, BH1, 
BH3 


BCI, BD1, BEI, 
BH1, BI1, BR1 


Program 
Organization 


Figures 


20, 24, 25, 
26, 27, 28, 
32, 35, 38 


38 

38.2 
38.2 
38.1 


20, 21, 22, 
24 


22, 34 


22, 24, 25, 
32, 38 


24, 25, 27, 
28, 32 


24, 25, 27, 
28, 33, 34 


26, 29, 30, 
31 


27, 32, 33, 
34 


28, 33, 34 


34 


26, 28, 29 


24, 25 


24, 25, 26 
27, 28 


37 


38 


External Procedure Directory 
Procedure Module Descriptive 
Name Name Name 
IDA019RW IDA019RW Buffer Management, Part 2 
IDA019RX IDA019RX Path Processing Driver 
IDAO19RY IDAO19RY Shared Resources Buffer Management 
IDA019RZ IDA019RZ Buffer Management Interface 
IDAOI9R1 IDAO19R1 Record Management: Request Decode and 
Validate 
IDA019R2 IDA019R2 Buffer Management, Part 1 
IDA019R3 IDA019R3 I/O Management 
IDA019R4 IDA019R4 Keyed/Addressed Request Driver 
IDAO19RS IDAO19RS I/O Error Analysis 
IDA019R6 IDA019R6 Channel-End and Abnormal-End Appendages 
IDA019R7 IDA019R7 Asynchronous Routine 
IDAO19R8 IDAO019R8 Control-Interval Processing 
IDA019R9 IDA019R9 Page-Fix and Start-I/O Appendages 
IDA019SA IDAO19SA Control-Interval Initialization- 
Create Entry-Sequenced Data Set 
IDA019SB IDA019SB Dynamically Build Channel Program 
Area for Shared Resources 
IDA019SF IDA019SF Control-Area Split-Spanned Records 
IDAO019S1 IDAO19S1 Improved Control-Interval Processing 
Driver 
IDA019S3 IDA019S3 Improved Control-Interval Processing- 
I/O Management 
IDA0192A IDA0192A VSAM Open String 
IDA0192B IDA0192B Open a Cluster 
IDA0192C IDA0192C VSAM Open/Close: Catalog Interface 
IDA0192D IDA0192D Stage/Destage (ACQUIRE/RELINQUISH) 
IDA0192F IDA0192F Open Base Cluster, Path, and Upgrade 
Alternate Index 
IDA0192G IDA0192G Data Space Security Verification 
IDA0192I IDA0192I1 ISAM Interface: Open Processing 
IDA0192M IDA0192M Virtual-Storage Management 
IDA0192P IDA0192P VSAM Open/Close/EOV: Problem Determination 
IDA0192S IDA0192S VSAM Open/Close/EOV: SMF Record Build 
IDA0192V IDA0192V Volume Mount and Verify 


Method of 
Operation 
Diagrams 
BQ1 


BP1, BP2, BP3, 
BS1, BS2 


AD6, BB1, BK1, 
BK2, BL1 


BS1, BS2 
BS1, BT1 


BC1, BD1, BEI, 
BF1, BH3, BQ1, 
BRI 


BB2, BK1, BL1 
BS3, BT1 
BT1 


BM1, BN1, BN2, 


BN3 
BT1 


BE1, BF1, BGI 
BG2, BG3, BK2 


BH4 
BN1, BN3 


BN1, BN3 


AC1, AC2, AC7, 
DH1 


AC4, AC5, AC6 
AC2,AC4, ACS, 


AC6, ADS, AD6, 


AE1, DD1, DE1 
AD5 


AC3, AC4, ACS, 
AC6 


AC7 


AC3 


27, 38 


20, 21, 23, 
24, 35, 36 


38 
20, 22, 38 


20, 21, 22, 
24, 25, 36, 
37 


38 


26, 29, 30 


28 


8,9 


9, 13, 15, 
16, 17 


9, 13, 15, 
17 


9 


16 
9, 11, 18 


9, 13, 15 
17 


9, 13, 15, 
17 


9,17 
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External Procedure Directory 


Procedure 
Name 


IDA0192W 


IDA0192Y 
IDA0192Z 
IDA0200B 
IDA0200S 
IDA0200T 


IDA0231B 
IDA0231T 
IDA0557A 


IEFAB410 
IEFAB411 
IEFNB902 
IFGO191X 
IFGOI91Y 
IFGO192A 


IFG0192Z 
IFG0200N 
IFGO550Y 
IGGPACDV 


IGGPADGO 
IGGPALEC 


IGGPALT 


IGGPALT2 
IGGPALVL 
IGGPALVR 
IGGPAOCI 
IGGPAUPG 
IGGPAXCI 
IGGPBJFB 
IGGPBMR 
IGGPCBPT 
IGGPCCCR 


IGGPCDVR 


IGGPCKAU 
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Module 
Name 


IDA0192W 


IDA0192Y 
IDA0192Z 
IDA0200B 
IDA0200S 
IDA0200T 


IDA0231B 
IDA0231T 
IDA0557A 


IEFAB410 
IEFAB411 
IEFNB902 
IFGO191X 
IFGO191Y 
IFG0192A 


IFG0192Z 
IFG0200N 
IFG0200N 
IGGOCLAB 


IGGOCLAW 
IGGOCLBE 


IGGOCLBD 


IGGOCLAX 
IGGOCLBE 
IGGOCLBN 
IGGOCLAG 
IGGOCLB2 

IGGOCLAG 
IGGOCLA6 

IGGOCLBR 
IGGOCLA6 

IGGOCLAG 


IGGOCLAT 


IGGOCLBM 


Descriptive 
Name 


Channel Program Area Build 


String Build and Shared-Resource Processor 
Control Block Build 

Close a Cluster 

ISAM Interface: Close Processing 

VSAM Close String 


Close (TYPE=T) a Cluster 
VSAM Close (TYPE=T) String 
VSAM End of Volume 


Private (VSAM User’s) Catalog Open 
Private (VSAM User’s) Catalog Close 
AMP Parameter Interpreter 

Catalog Open ACB Processor, Load 1 
Catalog Open ACB Processor, Load 2 
VSAM Open/Close/EOV String Load 


VSAM Catalog Open ACB Processor 
VSAM Catalog Close ACB Processor 
VSAM Catalog EOV ACB Processor 


Catalog Management Driver 


Add Group Occurrence (Set of Fields) 


Check for Index or Data and Sequence 
Set with Data 


CMS ALTER Processing 


Alter Catalog Record’s Field Value 
CMS ALTER: Volume Processing 
CMS ALTER: Volume Processing 
Assign Contiguous Control Intervals 
ALTER: Upgrade/Update 

Assign One Control Interval 

Build JFCB 

Bit-Map Manipulation Routine 
Compute Blocks of Track Value 


Checkpoint the Catalog Control Record 
(CCR) 


CMS (Catalog Management Services): Initial 
Processing 


Check the Caller’s Authorization To 
Access the Catalog Record 


Method of 
Operation 
Diagrams 

ACI, AC4, ACS, 
AC6 

AC1, ACS, AF1 
AC4, ACS, AC6 
AD?2, AD3, ADS 
AD1, AD6 


AD1, AD2, AD3 
AD4, AD6, DH1 


AE1, AE2, DE], 
DH1 


DB1, DD1, DE}, 
DH1 


DM1 


EB1, EH1, EH2, 
EH3 


DH1, DM2 

EH3 

EH3 

DM2, ED3, ED5 


DB1, DD1, EB! 


DBI, DD! 


Program 
Organization 
Figures 


9, 11 


9,11, 18 
9 
13 
12 
13 


10 
9, 10 


8,9, 12, 
13, 15, 17 


42, 45 


42, 46 


51.5 


45, 48, 51.6 


48, 50 


51.7 


40, 50 


40, 50 


wl 


J 


External Procedure Directory 


Procedure 
Name 


IGGPCMKY 
IGGPCNBO 
IGGPCONV 
IGGPCPLR 
IGGPCRTC 
IGGPDAVO 
IGGPDBVC 
IGGPDBDI 


IGGPDCCE 


IGGPDCCO 
IGGPDCDA 
IGGPDCIM 
IGGPDCLS 
IGGPDCMB 


IGGPDCME 


IGGPDCRA 
IGGPDCRC 
IGGPDEAX 
IGGPDEF 
IGGPDEFA 
IGGPDEFC 
IGGPDEFS 


IGGPDEIN 
IGGPDEL 


IGGPDELC 
IGGPDELS 
IGGPDEL2 
IGGPDEMV 


IGGPDEPT 
IGGPDEXA 
IGGPDFBO 
IGGPDFRS 


IGGPDFS2 


IGGPDF4T 


Module 
Name 


IGGOCLBO 
IGGOCLB8 
IGGOCLBZ 
IGGOCLAG 
IGGOCLA6 
IGGOCLBH 
IGGOCLAM 
IGGOCLAJ 


IGGOCLAN 


IGGOCLBO 
IGGOCLAP 
IGGOCLBX 
IGGOCLBS 
IGGOCLAK 


IGGOCLAE 


IGGOCLB4 

IGGOCLAS 
IGGOCLBS5 

IGGOCLAL 
IGGOCLBH 
IGGOCLAS 
IGGOCLAQ 


IGGOCLBW 
IGGOCLBG 


IGGOCLAF 
IGGOCLBL 
IGGOCLAV 
IGGOCLA7 


IGGOCLB5 
IGGOCLBG 
IGGOCLB8 
IGGOCLA8 


IGGOCLA6 


IGGOCLA7 


Descriptive 
Name 


Key-Range Verification 

Remove Candidate Volume Occurrences 
CONVERTYV Processing 

Check Preformat of Low-Key Range 

Convert Records to Tracks 

NonVSAM Volume Occurrence Construction 
CMS DEFINE: Validity-check control blocks 


CMS DEFINE: Build the Data Set and Index 
Catalog Records of a Cluster 


CMS DEFINE: Build the Cluster’s Catalog 
Record 


Define Data and Index Characteristics 

CMS DEFINE CATALOG Processing (2nd of 2) 
Integer Conversion 

DELETE Cluster/AIX Records 


CMS DEFINE: Completion (Build the Volume 
Information Sets of Fields) 


CMS DEFINE CATALOG: Catalog Open, Build, 
and Close 


DEFINE CRA 

RBA Computing Routine 

Explicit DELETE AIX 

CMS DEFINE: Initial Processing 

CMS DEFINE NONVSAM Processing 

CMS DEFINE CATALOG Processing (1st of 2) 
CMS DEFINE SPACE Processing 


Modify: Delete/Insert Processing 


CMS DELETE CLUSTER/AIX/PATH/NONVSAM 
Processing 


CMS DELETE CATALOG Processing 
CMS DELETE SPACE Processing 
Delete a Set of Fields 


CMS DELETE: Extract the volume information 
set of fields 


Explicit DELETE PATH 
Extract Associations 
CMS DEFINE: Space Recovery 


Free Unused and Unneeded Storage 
Resources 


CMS DEFINE SPACE: Build the Data Space 
Group and Data Set Directory Entry Sets 
of fields 


Format-4 Volume Record Timestamp 


Method of 
Operation 


DGS, EC1 


ED1, ED2, ED3, 


ED4 


ED1, ED3, EE1 


EC1, EE] 


FJ3, EJ4 
ED2 


EE2 


FE1, EE3 
EFE2 
EJ1, EJ3 


EB1, EB2, EC1 


FB1, EF1 
FF1 


EB1, ED1, ED3 
EE1, EG1, EG2 


EB1, EJ1, EJ4, 50 


EJ3 

EB1, ELI 
EB1, EK1 
DM3 


EJ1, EJ3 


ED2, ED4 


EJ2 


50, 51 


50, 51 


42, 47 
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External Procedure Directory 


Procedure 
Name 


IGGPDGO 


IGGPDGOP 


IGGPDIAX 
IGGPDIPT 
IGGPDLET 
IGGPDLXT 
IGGPDLVM 
IGGPDOPN 
IGGPDRDA 
IGGPDRSP 
IGGPDSCB 


IGGPDSPC 
IGGPDTIM 
IGGPDUND 
IGGPDUCB 
IGGPDUPG 
IGGPDUSC 


IGGPDVMV 
IGGPEMIO 
IGGPEMSG 
IGGPEXPD 


IGGPEXT 


IGGPFDSP 
IGGPF4DQ 
IGGPF4RD 
IGGPF4WR 
IGGPGALO 
IGGPGDSP 
IGGPGET 


IGGPGETC 


IGGPGNEX 
IGGPGREC 
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Module 
Name 


IGGOCLAX 


IGGOCLAX 


IGGOCLB5 
IGGOCLBS5 
IGGOCLBL 
IGGOCLBG 
IGGOCLBL 
IGGOCLBG 
IGGOCLAN 
IGGOCLBY 
IGGOCLAN 


IGGOCLBX 
IGGOCLAL 
IGGOCLB8 
IGGOCLBL 
IGGOCLBS 
IGGOCLA7 


IGGOCLA7 

IGGOCLAF 
IGGOCLAF 
IGGOCLAX 


IGGOCLAZ 


IGGOCLAI 
IGGOCLBU 
IGGOCLBU 
IGGOCLBU 
IGGOCLBZ 
IGGOCLBJ 
IGGOCLBI 


IGGOCLBI 


IGGOCLAW 
IGGOCLBA 


Descriptive 
Name 


Modify: Delete Group Occurrence (Set of 
Fields) Processing 


Modify: Delete Group Occurrence Pointer 
(Set of Fields Pointer) Processing 


Implicit DELETE AIX 
Implicit DELETE PATH 
Delete Volume Entry Records 
DELETE Exit Routine 

Build Volume Mount Interface 
OPEN Determination 
DEFINE AMDSSB Processing 


CMS DEFINE CLUSTER Processing (5th Module) 


CMS DEFINE: Initial Processing (Space 
Calculations and Build the Cluster 
Catalog Record) 


CMS DEFINE CLUSTER Processing (4th Module) 


CMS DEFINE: Call the System Timer 


CMS DEFINE: Undo the Previous Processing 


DELETE Upgrade Associations 


CMS DELETE: Scratch the Data Space 
(Format 1—Identifier-—DSCB) from the 
Volume’s VTOC 


CMS DELETE: Mount and Verify Volumes 
I/O Error Message Writer 
Error Message Writer 


Expand a Catalog Record’s Variable- 
length Field 


Extract Processing 


DELETE SPACE Processing 

Dequeue the Format 4 DSCB 

Read the Format 4 DSCB 

Write the Format 4 DSCB 

CONVERTV: GET all Low-Range Records 
LOCATE: GENDSP Processing 


GET: Call Record Management to Retrieve 
A Catalog Record 


GET: Call Record Management 
to Retrieve a Catalog Record 


Format a New Catalog Extension Record 


Retrieve a Catalog Record 


Method of 
Operation 
Diagrams 


EFJ1, EJ2, EJ3 
EFJ3, EJ4 


DM2 


DE1, DE2, DI3, 
DI4, DJ2 


EK1 
EE3, EM1 
EE3, EM1 
EM1 
DB1, DF1 


DC2, DI4, DI6, 
DJ1 


DL1, DL2 


45, 48 


41, 42, 45, 
47, 48 


J 


External Procedure Directory 


Procedure 
Name 


IGGPGVAL 


IGGPIGOP 


IGGPINIT 
IGGPINMD 
IGGPIORA 
IGGPISCI 


IGGPLDCS 
IGGPLOC 
IGGPLSP 


IGGPLSTC 
IGGPMCO 


IGGPMCO2 


IGGPMCRA 
IGGPMEBM 


IGGPMGO 


IGGPMOD 


IGGPMODI 
IGGPORDA 
IGGPPAD 


IGGPPAIX 
IGGPPATH 
IGGPPDE 


IGGPPREC 


IGGPPSEM 
IGGPPUPC 


IGGPRACC 
IGGPRAEA 
IGGPRAG 

IGGPRAOP 
IGGPRAOR 
IGGPRAPA 


Module 
Name 


IGGOCLBA 


IGGOCLAW 


IGGOCLBC 
IGGOCLB6 

IGGOCLAG 
IGGOCLAG 


IGGOCLBK 
IGGOCLAZ 
IGGOCLBK 


IGGOCLBQ 
IGGOCLAC 


IGGOCLAD 


IGGOCLA7 
IGGOCLAE 


IGGOCLAX 


IGGOCLAV 


IGGOCLDA 
IGGOCLAN 
IGGOCLAG 


IGGOCLB9 
IGGOCLB9 
IGGOCLAG 


IGGOCLAW 


IGGOCLAN 
IGGOCLAG 


IGGOCLBO 
IGGOCLBO 
IGGOCLBO 
IGGOCLAD 
IGGOCLBO 
IGGOCLBO 


Descriptive 
Name 


Get A Catalog Record Field 


Insert A Group Occurrence Pointer 

(Set of Fields Pointer) 

UPDATE-Extend: Initialization 

Build User Authorization Interface 

Decode record management I/O error codes 


Insure Catalog Control Interval 
Availability 


LSPACE: Gather the Available Space Data 
LOCATE Processing 
LSPACE Processing 


CMS LISTCAT Processing 


DEFINE CATALOG: Master Catalog Build and 
Open (Ist of 2) 


DEFINE CATALOG: Master Catalog Build and 
Open (2nd of 2) 


DELETE: Verify CRA Volume Mount 


Handle Multiple Extents for Catalog Open 
and Build 


Move Group Occurrences (Sets of Fields) 
From One Extension Record Into Another 


Modify: Initial Processing 


Build Interface to MODIFY Function 
DEFINE Processing 


PUT Add: Call Record Management To Write 
A New Catalog Record 


DEFINE AIX 
DEFINE PATH 


ERASE: Call Record Management To 
Erase A Catalog Record 


Call PUT-Add or PUT-Update to Write a 
Catalog Record, Then Call SMF 


DEFINE: Validity-Check Input Parameters 


PUT-Update: Call Record Management to 
Rewrite A Catalog Record 


Checkpoint CRA CCR 
CRA I/O Error Analysis 
CRA GET 

Open CRA 

Orient to CRA 

CRA PUT Add 


Method of 
Operation 
Diagrams 

DE2, DL1, DL2, 
DM2 


DM1 


DK1 
DB1, DE1, DE2 


DB1, DK1, EG2, 
FJ3 


EBI, Ell 


EE2 


D/I4, DI6, DJ1, 


DM1, DM3, EH3, 


EM1 
EE3 


41, 42, 46 


45, 48 


43 


51 
51.3 


51 
51 
47, 51.4 


42, 47, 50 


51 
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External Procedure Directory 


Procedure 
Name 


IGGPRAPC 
IGGPRAPD 
IGGPRAPU 
IGGPRAPV 
IGGPRARC 
IGGPRASC 
IGGPRAX 
IGGPRCCR 
IGGPRET1 
IGGPRPLF 
IGGPRPLM 
IGGPRUS 


IGGPSALL 


IGGPSALS 
IGGPSCAT 


IGGPSCNC 


IGGPSCNF 
IGGPSGOP 


IGGPSHNK 


IGGPSLEL 
IGGPSLEN 
IGGPSLOC 


IGGPSMF 
IGGPSMFA 


IGGPSMFF 
IGGPSMFG 
IGGPSMFL 
IGGPSMFR 
IGGPSMFS 
IGGPSPAC 
IGGPSPSC 
IGGPSSCR 


IGGPSVOL 


IGGPTNXO 
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Module 
Name 


IGGOCLBO 
IGGOCLBO 
IGGOCLBO 
IGGOCLDA 
IGGOCLBO 
IGGOCLBO 
IGGOCLBO 
IGGOCLAG 
IGGOCLBP 

IGGOCLAH 
IGGOCLAH 
IGGOCLB7 


IGGOCLAR 


IGGOCLAU 
IGGOCLAH 


IGGOCLAY 


IGGOCLAZ 
IGGOCLAV 


IGGOCLAX 


IGGOCLAM 
IGGOCLAA 
IGGOCLAM 


IGGOCLB3 
IGGOCLBV 


IGGOCLBV 
IGGOCLB3 

IGGOCLBV 
IGGOCLBV 
IGGOUCLBV 
IGGOCLBP 
IGGOCLB6 
IGGOCLBF 


IGGOCLBC 


IGGOCLBI 


Descriptive 
Name 


CRA Record Chain 

CRA PUT Delete 

CRA PUT Update 

Format-4 DSCB Timestamp Processing 
Read CRA CCR 

Ensure Sufficient CRA Cls 

CRA Exit Routine 

Read Catalog Control Record 

Return point from DADSM EXTEND 
Dequeue the Catalog 

RPL Manager 

Reset a Reusable Data Set 


Suballocate: Candidate Volume Assignment 


Suballocate: Space Assignment 


Search Catalog Processing 


Initial CTGPL Processing 


Search For a Group Occurrence Pointer 
(Set of Fields Pointer) 


Shrink A Catalog Record’s Variable-Length 
Field 


SUPERLOCATE Processing 
SUPERLOCATE Processing 
LOCATE: Super-Locate Processing 


SMF-for-ALTER: Write Processing 
SMF: Build a Format-63 SMF Record 


SMF: Free the Virtual Storage Obtained 
SMF-for-ALTER: Read Processing 
SMF: Build a Format-69 SMF Record 
SMF: Build a Format-68 SMF Record 
SMF: Build a Format-67 SMF Record 
UPDATE-Extend: Obtain More Space 
Check for Security By-Pass 


Subscratch: Release A Cluster’s Space 
Within a VSAM Data Space 


Search For the Volume Information Set- 
of-Fields 


Calculate SUMTT Value 


Method of 
Operation 
Diagrams 


DC2 


DE1, DH1, DI3, 
DI4, DIS, DI6é 


Dil, DJ1, ED1, 
ED3, EE1, EH3 


DJ1, DJ2, EJ2 


DB1, DC1, DC2, 
EG1, EMI 


DB1, DE1, DE2, 
DM 1 


DE1, DE2 
DE1, DE2 


DM2 


DG2, DG3 
DG1, DG2, DG3 


DB1, DG1, DG2, 
DG3, DG4 


ED2, ED4, EDS, 
EE2 


DK1 


DD1 
DI5, EJ1 


DIl 


Program 
Organization 
Figures 


51.17 
51.18 
51.7,51.10 


44 


43,50, 51 


43, 49, 51 
40,50 


40, 41, 42 


47, 48 


40 
40 


External Procedure Directory 


Procedure 
Name 


IGGPTSTS 
IGGPTXO 
IGGPUADD 
IGGPUCRS 


IGGPUDEL 
IGGPUPD 
IGGPUPDE 
IGGPUPGD 
IGGPVALI 
IGGPVRD 


IGGPVMSC 


IGGPWCAT 
IGGPWCRA 


IGGPWFLR 
IGGPWTSO 
IGGPXDGO 
IGGPXEL2 
IGGPXEXT 
IGGPXIO 


IGGPXLT2 
IGGPXMOD 
JGGPXRIO 
IGGPXVAL 
IGGOCLAI 
IGGOCLCA 
IGGOCLCB 
IGGOCLC9 
IGG0102G 


IMDUSRF9 


Module 
Name 


IGGOCLBA 
IGGOCLBI 
IGGOCLB1 
IGGOCLBI 


IGGOCLBI1 

IGGOCLAV 
IGGOCLBB 
IGGOCLAZ 
IGGOCLBZ 
IGGOCLBN 


IGGOCLA7 


IGGOCLDA 
IGGOCLDA 


IGGOCLAG 
IGGOCLB6 
IGGOCLBT 
IGGOCLBT 
IGGOCLBS 
IGGOCLAG 


IGGOCLBT 
IGGOCLBT 
IGGOCLBO 
IGGOCLBS 
IGGOCLAI 
IGGOCLCA 
IGGOCLCB 
IGGOCLC9 
1GG0102G 


IMDUSRF9 


Descriptive 
Name 


CTGFL-for-Tests Processing 
Update SUMTT in Volume Record 
Add Upgrade Association 


GET a CRA Record by 
CI Number 


Delete Upgrade Association 
UPDATE: Initial Processing 
UPDATE-Extend Processing 
PUT Upgrade Processing 
CONVERTV: Validity-Checking 


ALTER: Remove VSAM Space 
from Volume 


CMS DELETE: Delete all space information in 
the volume catalog record 


Write Volume Records to Catalog 


Write Self-Describing and 
Volume Records to CRA 


Write Free Record 

Write Messages To A TSO Terminal User 
Add Derived Group Occurrence 

Delete Derived Group Occurrence 
Extract Derived Group Occurrence 


Issue the GET, PUT, or ERASE Macro 
Instructions 


Alter Derived Field Value 

Modify Derived Group Occurrence 
CRA GET/PUT Routine 

Get Derived Field Value 

Catalog Management Transient Load 
OS/VS Catalog Request Handler 
VSAM Catalog Request Handler 
Catalog Management First Load 


OS/VS DADSM: Obtain Space For a VSAM 
Data Space 


IMDPRDMP-Format Appendage 


Method of 
Operation 
Diagrams 


DE1, DH1 


DB1, DH1, DI3 
DH1, DI1, DI2 
DE1 
EM! 


Program 
Organization 
Figures 


41, 42 
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Procedure Calls Directory 


Procedure Calls Directory: Open/Close/EOV Modules 2 


This table lists each Open/Close/EOV module and the modules it calls. 


Calling 
Module 


IDA0192A 
IDA0192B 


IDA0192C 
IDA0192D 
IDA0192F 
IDA0192G 
IDA0192I 
IDA0192M 
IDA0192P 
IDA0192S 
IDA0192V 
IDA0192W 
IDA0192Y 
IDA0192Z 
IDA0200S 
IDA0200B 
IDA0200T 
IDA0231B 
IDA0231T 
IDA0557A 


Calling 
Module 


IGCOA05B 
IDAOA05B 
IDAOBO5B 
IDA0C06C 


Called Modules 
IDA0192B, IDA0192C, IDA0192F, IDA0192M, IDA0192P, IDA0192S 


IDA0192C, IDA0192D, IDA0192M, IDA0192P, IDA0192Y, 
IDA0192Z 


IDA0192P 
IDA0192M, IDA0192P, IDA0192V 
IDA0192C 


IDA0192C, IDA0192D 

IDA0192M 

IDA0192M, IDA0192W 

IDA0192M, IDA0192Y 

IDA0192C, IDA0192D, IDA0192P, IDA0192S 
IDA0192C, IDA0192P, IDA0192Y, IDA0200B 

IDA0192C, IDA0192D, IDA0192P, IDA0192S 

IDA0192P, IDA0231B 

IDA0192C, IDA0192D, IDA0192P, IDA0192S, IDA0192V 


Procedure Calls Directory: Checkpoint /Restart 


Called Modules 
IDAOA05B 
IDAOBOSB, IDA0192M 


Procedure Calls Directory: Record Management Modules 


This table lists each Record Management module and the modules and 
procedures it calls. 


Calling 
Module 


IDAO19RA 


IDAO19RB 
IDAOI9RC 


Called Procedure 
(and its Module) 


IDAABF (IDA019RW), IDAFRBA (IDA019RW), IDAFREEB 
(IDA019RZ), IDAGNXT (IDA019RZ), IDAGRB (IDA019RZ), 
IDASBF (IDA019RZ), IDAWAIT (IDA019RZ), IDA019RB 


IDAFREEB (IDA019RZ), IDAGRB (IDA019RZ), IDA019RC 
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Calling 
Module 


IDAOI9RE 


IDA019RF 


IDA0NI9RG 


IDA019RH 
IDAO19RI 


IDAO19RJ 


IDAOI9RK 


IDAO19RL 
IDA019RM 


IDAO019RN 
IDA019RO 
IDAO19RP 


IDA019RQ 


IDA019RR 


IDAO19RS 


IDAO19RT 


IDA019RU 


IDA019RV 


IDA019RW 


IDA019RX 


Called Procedure 
(and its Module) 


IDAFREEB (IDA019RZ), IDAGNFL (IDA019RZ), IDAGRB 
(IDA019RZ), IDASBF (IDA019RZ), IDATJXIT (IDAOI19RP), 
IDAWRBFR (IDA019RZ), IDAO19RF, IDA019RH, IDA019RM 


IDAABF (IDA019RW), IDAAIBF (IDA019RW), IDAEOVIF 
(IDA019R5), IDAFREEB (IDA019RZ), IDAGNNFL (IDA019RZ), 
IDAGNXT (IDA019RZ), IDAGRB (IDA019RZ), IDASBF 
(IDA019RZ), IDATJXIT (IDA019RP), IDAWRBFR (IDA019RZ), 
IDAO19RI, IDAO19RK, IDA019RM, IDAO019SF 


IDAAQR (IDA019RN), IDAEOVIF (IDA019RS5), IDAER 
(IDA019RN), IDAFREEB (IDA019RZ), IDAGNFL (IDA019RZ), 
IDAR (IDA019RJ), IDASPNPT (IDAQ19RT), IDAWR (IDAO19RJ) 


IDAWRBFR (IDA019RZ), IDA019RC 


IDAAQR (IDAO1I9RN), IDAEOVIF (IDA019R5), IDAFREEB 
(IDA019RZ), IDAGNFL (IDA019RZ), IDAGRB (IDA019RZ), 
IDA019RB, IDA019RH, IDAO19RJ 


IDAAQR (IDA019RN), IDAER (IDA019RN), IDAFREEB 
(IDA019RZ), IDAGRB (IDA019RZ), IDAIST (IDA019RG), 
IDAIVIXB (IDA019RH), IDASPACE (IDA019RH), IDASPNPT 
(IDA019RT), IDAWRBFR (IDA019RZ) 


IDAEOVIF (IDA019R5), IDAFREEB (IDA019RZ), IDAGNFL 
(IDA019RZ), IDAWRBFR (IDA019RZ) 


IDATJXIT (IDA019RP), IDA019RM, IDA019RS 


IDATJXIT (IDAO1I9RP), IDAO19RE, IDAO019RT, IDAO19RU, 
IDAO19SA 


IDAEOVIF (IDAO19RS), IDAO1I9RK 
IDAFREEB (IDA019RZ), IDAGRB (IDA019RZ), IDA019RB 


IDAEXEX (IDA019RS), IDAEXITR (IDA019RS5), IDASBF 
(IDA019RZ), IDAWRBFR (IDA019RZ), IDA019RG, IDAO19RK, 
IDA019R5, IDAO19SA 


IDAABF (IDA019RW), IDADRQ (IDA019R5), IDAEOVIF 
(IDA019R5), IDAFREEB (IDA019RZ), IDAGNNFL (IDA019RZ), 
IDAGNXT (IDA019RZ), IDARRDRL (IDA019RR), IDATJXIT 
(IDAO19RP), IDAWRBFR (IDA019RZ), IDAO1I9RK 


IDAABF (IDA019RW), IDAFREEB (IDA019RZ), IDAGNXT 
(IDA019RZ), IDAGRB (IDA019RZ), IDATJXIT (IDAO19RP), 
IDAWRBEFR (IDA019RZ), IDA019RQ 


IDACHKKR (IDA019RM), IDADRQ (IDA019R5), IDAGRB 
(IDA019RZ), IDAGWSEG (IDA019RZ), IDAIVIXB (IDA019RH), 
IDAJRNSR (IDAO19RT), IDAREPOS (IDAO19RE), IDASBF 
(IDA019RZ), IDAWRBFR (IDA019RZ), IDAO19RC, IDAO19RF 


IDAABF (IDA019RW), IDAADSEG (IDAO19RS), IDAAIBF 
(IDA01I9RW), IDADRQ (IDA019R5), IDAFREEB (IDA019RZ), 
IDAGNXT (IDAO19RZ), IDAGRB (IDA019RZ), IDAIVIXB 
(IDA019RH), IDAMVSEG (IDA019RS), IDAREPOS (IDAOI19RE), 
IDASBF (IDA019RZ), IDATJXIT (IDAO19RP), IDAWRBFR 
(IDA019RZ), IDAO19RC, IDAO19YRE, IDA019RF, IDA019SA 


IDADRQ (IDAO19R5), IDAGETWS (IDA019RX), IDARELWS 
(IDA019RX), IDASBF (IDA019RZ), IDA019R4 


IDAABF (IDA019RW), IDAFREEB (IDA019RZ), IDAGNXT 
(IDA019RZ), IDAGRB (IDA019RZ), IDA019RA, IDAO19RC 


IDAGRB (IDA019RZ), IDAWAIT (IDA019RZ), IDAWRBFR 
(IDA019RZ), IDA019RC, IDAO1I9RV, IDAO19R3 


IDADRQ (IDA019RS5), IDAENDRQ (IDAO019RP), IDAXGPLH 
(IDA019RU), IDA019R4 
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Calling 
Module 


IDAOI9SRY 


IDA019RZ 
IDAOI9R1 


IDA019R2 


IDA019R3 
IDAO19R4 


IDAOI9R5 
IDAO19R6 
IDA019R7 
IDAO19R8 


IDAOI9RI 
IDAOI9SA 


IDA019SB 
IDAO19SF 


Called Procedure 
(and its Module) 


IDADRQ (IDA019RS), IDAEXEX (IDA019R5), IDAFRBA 
(IDA019RW), IDATJXIT (IDA019RP), IDAWAIT (IDA019RZ), 
IDAOI9R3, IDAOI9RS 


IDAGWSGW (IDA019RW), IDAOI9RY, IDA019R2, IDAUPXIT 


IDAENDRQ (IDA019RP), IDAERROR (IDA019R5), IDAFREEB 
(IDA019RZ), IDAMRKBF (IDA019RZ), IDARSTRT (IDA019RS5), 
IDASBF (IDA019RZ), IDASCHBF (IDA019RZ), IDAWRBFR 
(IDA019RZ), IDAWRTBF (IDA019RZ), IDAO19RK, IDAO19RR, 
IDAOI9SRX, IDA019R4, IDAOI9RS, IDA019R8 


IDAFRBA (IDA019RW), IDARVRS1 (IDA019RV), IDAWAIT 
(IDA019RZ), IDAO19R3 


IDADRQ (IDA019R5), IDAEOVIF (IDA019R5), IDAO19SB 


IDAABF (IDA01I9RW), IDAADVPH (IDA019RV), IDADARTV 
(IDA019RT), IDADRQ (IDA019RS5), IDAFREEB (IDA019RZ), 
IDAGNNEL (IDA019RZ), IDAGNXT (IDA019RZ), IDAGRB 
(IDA019RZ), IDARXBD (IDA019RX), IDATJXIT (IDA019RP), 
IDAWRBFR (IDA019RZ), IDAO19RA, IDA019RK, IDAOI9RL, 
IDA0I9RM, IDA019RU 


IDAUPXIT 


IDAABF (IDA019RW), IDADRQ (IDA019R5), IDAEOVIF 
(IDA019R5), IDAEXCL (IDA019RZ), IDAFRBA (IDA019RW), 
IDAFREEB (IDA019RZ), IDAGNNFL (IDA019RZ), IDAGNXT 
(IDA019RZ), IDAGRB (IDA019RZ), IDASBF (IDA019RZ), 
IDATJXIT (IDAO19RP), IDAWRBFR (IDA019RZ), IDAO19RK, 
IDA019RO 


IDAEOVIF (IDA019R5), IDAFREEB (IDA019RZ), IDAGNNFL 
(IDA0I9RZ), IDAGRB (IDA019RZ), IDATJXIT (IDAO19RP), 
IDAWRBER (IDA019RZ), IDA019RG, IDA019RK, IDA019RU 


IDADRQ (IDA019RS) 


IDAABF (IDA019RW), IDAEOVIF (IDA019R5), IDANEWRD 
(IDAO19RI), IDAFREEB (IDA019RZ), IDAGNNEFL (IDA019RZ), 
IDAGRB (IDA019RZ), IDAHLINS (IDA019RI), IDASBF 
(IDA019RZ), IDAWRBFR (IDA019RZ), IDA019RM, IDAO19RV 
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Procedure Calls Directory: Catalog Management Procedures 


This table contains each Catalog Management module and external and 
internal procedures within the module. The internal and external calls of each 
procedure are listed. 


Calling 

Module and Its 

Procedures 

IGGOCLAA 
External 


IGGPSLEN 


Internal 
IGGPSLCG 
IGGPSLIV 
IGGPSLR 
IGGPSLY 
IGGOCLAB 
External 


IGGPACDV 


Internal 
IGGOCLAC 
External 
IGGPMCO 
Internal 
IGGPSUCB 
IGGOCLAD 
External 
IGGPMCO2 
IGGPRAOP 
IGGOCLAE 
External 
IGGPDCME 
IGGPMEBM 
Internal 
IGGPDCBO 
IGGPDCCB 
IGGPDCOC 
IGGPDCPR 
IGGOCLAF 
External 


IGGPDELC 


External Procedures Called 
(Procedures Outside the Module) 


IGGPSLEL 


IGGPEXT, IGGPGET, IGGPSLEL 
IGGPEXT, IGGPGET, IGGPSLEL 
IGGPEXT, IGGPGET, IGGPSLEL 


IGGPCDVR, IGGPCKAU, IGGPGDSP, 
IGGPLOC, IGGPLSP, IGGPMCO, 
IGGPSCAT, IGGPSCNC, IGGPSLOC, 
IGGPUPD 


IGGPMCO2 


IGGPDCRC, IGGPMOD 
IGGPBMR 


IGGPDUND, IGGPF4RD, IGGPF4WR 
IGGPMCO2, IGGPSMFA 
IGGPXID 


IGGPCCCR, IGGPDBVC, IGGPEXT, 
IGGPFDSP, IGGPF4RD, IGGPF4WR, 
IGGPGET, IGGPPDE, IGGPSCAT 


Internal Procedures Called 
(Procedures Within the Module) 


IGGPSLCG, IGGPSLIV, IGGPSLR, 
IGGPSLY 


IGGPSLY 


IGGPSLY 


IGGPCRAD 


IGGPDCOC 


IGGPDCCB, IGGPDCBO, IGGPDCPR 


IGGPDLER, IGGPSDSP 
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Procedure Calls Directory: Catalog Management Modules 


Calling 
Module and Its 
Procedures 


IGGPEMIO 
IGGPEMSG 
Internal 
IGGPDCDS 
IGGPDLER 
IGGPNFND 
IGGPSDSP 
IGGOCLAG 
External 


IGGPAOCI 


IGGPAXC] 


IGGPCCCR 
IGGPIORA 
IGGPISCI 


IGGPPAD 
IGGPPADC 
IGGPPDE 
IGGPPUPC 
IGGPRCCR 
IGGPXIO 
Internal 
IGGPANCI 
IGGPCHAC 
IGGPRBAP 
IGGPTRPL 
IGGOCLAH 
External 


IGGPSCAT 


IGGPRPLF 
IGGPRPLM 
Internal 
IGGPIOSI 
IGGPPLHC 
IGGPSCA 


External Procedures Called 
(Procedures Outside the Module) 


IGGPDOPN, IGGPEXT 
IGGPDF4T 


IGGPEMIO, IGGPEMSG 
IGGPGET, IGGPRASC 


IGGPRAPA, IGGPRAP4 


IGGPRAPD 
IGGPRAPU 


IGGPCKAU, IGGPGET, IGGPUCRS 


Internal Procedures Called 
(Procedures within the Module) 


IGGPNFND 


IGGPANCI, IGGPCCCR, IGGPRCCR, 
IGGPXIO 


IGGPANCI, IGGPCCCR, IGGPRCCR, 
IGGPXIO 


IGGPRBAP, IGGPXIO 


IGGPANCI, IGGPCCCR, IGGPRCCR, 
IGGPXIO 


IGGPRCCR, IGGPXIO 
IGGPRCCR, IGGPTRPL, IGGPXIO 
IGGPTRPL, IGGPXIO 

IGGPRBAP, IGGPXIO 

IGGPIORA 


IGGPCHAC, IGGPIORA 


IGGPXIO 


IGGPIOSI, IGGPRPLF, IGGPRPLM, 
IGGPSCA 


IGGPPLHC 
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Calling 
Module and Its External Procedures Called Internal Procedures Called 
Procedures (Procedures Outside the Module) (Procedures within the Module) 
IGGOCLAI 

External 


IGGPDFM!1 IGGPF4DQ, IGGPF4RD — 


IGGPFDSP IGGPDLET, IGGPDLVM, IGGPDOPN, IGGPFDEX, IGGPFDXT 
IGGPDUCB, IGGPEXT, IGGPGET, 
IGGPMOD, IGGPPUPC 


Internal 

IGGPFDEX — = 

IGGPFDXT — = 
IGGOCLAJ 

External 


IGGPDBDI IGGPDCMB, IGGPDFBO, IGGPDTIM, IGGPDCNV, IGGPDERS, 
IGGPGET, IGGPUADD IGGPDRCS, IGGPDSPO 


Internal 

IGGPDCNV_  IGGPSALL — 
IGGPDEXD — — 
IGGPDFRE — = 
IGGPDFRS — IGGPDFRE 
IGGPDRCS — — 
IGGPDSEX — IGGPDEXD 


IGGPDSPO IGGPCNBO, IGGPDEFS, IGGPGET, IGGPDSEX 
IGGPSALL, IGGPTNXO, IGGPTXO 


IGGOCLAK 
External 


IGGPDCMB — IGGPDBVO, IGGPDMOP, 


IGGPDOMF 
Internal 
IGGPDBCV — IGGPDEXD 


IGGPDBVO — IGGPDBCV, IGGPDEXD, 
IGGPDRCA, IGGPDRNG, IGGPDSSP 


IGGPDEXD- _ 


IGGPDMOP 
IGGPDOMF 
IGGPDRCA 
IGGPDRNG 
IGGPDSSP 


IGGOCLAL 


External 
IGGPDEF 
IGGPDBVC 
IGGPDTIM 


IGGPMOD 
IGGPSMFA 


IGGPDSCB 


IGGPDEXD 


IGGPDCAV, IGGPDDEP 
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Calling 
Module and Its 


Procedures 


Internal 


IGGPDCAV 


IGGPDCDE 
IGGPDCSF 
IGGPDCWC 
IGGPDDEP 


IGGPDDNP 
IGGPDEDE 
IGGPDFSC 
IGGPDRPG 
IGGPDSTY 
IGGPDWAI 


IGGOCLAM 


External 
IGGPDVC 
IGGPSLEL 
IGGPSLOC 
Internal 
IGGPSLEI 
IGGPSLIN 


IGGOCLAN 


External 
IGGPDCCE 
IGGPDRDA 
IGGPDSCB 


IGGPPSEM 
Internal 
IGGPDALR 
IGGPDBSF 
IGGPDSPF 


IGGOCLAP 


External 
IGGPDCDA 
Internal 
IGGPDCON 
IGGPDCPC 
IGGPDCSP 
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External Procedures Called 
(Procedures Outside the Module) 


IGGPGET 


IGGPCMKY 


IGGPEXT 
IGGPSLEN 


IGGPAOCI, IGGPPAD 
IGGPDRSP, IGGPDSPC 
IGGPDBDI, IGGPDCDA, IGGPDEFC 


IGGPAOCI, IGGPDCCE, IGGPPAD 


Internal Procedures Called 


(Procedures within the Module) 


IGGPDBVC, IGGPDCSF, 
IGGPDCWC, IGGPDDNP, 
IGGPDFSC, IGGPDRPG 


IGGPDBVC 
IGGPDBVC 


IGGPDCDE, IGGPDEDE, 
IGGPDSTY, IGGPDWAI 


IGGPDTIM 
IGGPDBVC 


IGGPDBVC 


IGGPSLIN 


IGGPSLEI 


IGGPDCCE 


IGGPDALR, IGGPDBSF, 
IGGPDRDA, IGGPDSPF, 
IGGPDUND 


IGGPXDCI 


IGGPDCVS 


IGGPDCON, IGGPDCPC 
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Procedure Calls Directory: Catalog Management Modules 


Calling 
Module and Its 
Procedures 


IGGPDCVS 
IGGOCLAQ 
External 


IGGPDEFS 


Internal 
IGGPCOBT 
IGGPDSXT 
IGGPFIBO 
IGGPF4PR 
IGGPIVER 
IGGPTMST 
IGGPVMTV 
IGGOCLAR 
External 


IGGPSALL 


IGGOCLAS 
External 


IGGPDEFC 


Internal 
IGGPDCBE 
IGGPDCEB 
IGGPDCFL 
IGGPDCHD 
IGGPDCIX 
IGGPDCLD 
IGGPDCPB 
IGGPDCRC 
IGGPDCSP 
IGGPDCVO 


IGGOCLAT 
External 


IGGPCDVR 


Internal 


IGGPCCLN 


External Procedures Called 
(Procedures Outside the Module) 


IGGPAXI, IGGPBJFB, IGGPCBPT, 
IGGPCKAU, IGGPCRTC, IGGPDCRA, 
IGGPDFS2, IGGPDTIM, IGGPGET, 
IGGPISCI, IGGPLSP, IGGPPAD, 
IGGPSCAT 


IGGPF4DQ, IGGPF4RD, IGGPF4WR 


IGGPF4RD, IGGPF4WR 


IGGPEXT, IGGPGET, IGGPISCI, 
IGGPMOD, IGGPSALS 


IGGPCCCR, IGGPDCME 


IGGPDEFS, IGGPSALL, IGGPMEBM 


IGGPALT, IGGPCKAU,IGGPCONV, 
IGGPDEF, IGGPDEFA, IGGPDEFS, 
IGGPDEL, IGGPDELC, IGGPDELS, 
IGGPLSTC, IGGPSCAT 


Internal Procedures Called 
(Procedures within the Module) 


IGGPDCSP 


IGGPCOBT, IGGPDSXT, 
IGGPF1BO, IGGPF4PR, 
IGGPIVER, IGGPTMST, 
IGGPVMTV 


IGGPDCBE, IGGPDCSP, IGGPDCVO 


IGGPDCEB, IGGPDCPB 
IGGPDCME 
IGGPDCRC 
IGGPDCRC 
IGGPDCRC 


IGGPDCEFL, IGGPDCHD, 
IGGPDCIX, IGGPDCLD 


IGGPCCLN 
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Calling 
Module and Its 
Procedures 


IGGOCLAU 


External 
IGGPSALS 
Internal 
IGGPEDS 


IGGOCLAV 


External 
IGGPDEL2 


IGGPMOD 
IGGPSGOP 
IGGPUPD 
Internal 


IGGPSFPL 


IGGOCLAW 


External 


IGGPADGO 


IGGPGNEX 
IGGPGREL 
IGGPIGOP 
IGGPPREC 
Internal 


IGGPAGOP 


IGGPASPT 
IGGPMVGO 


IGGOCLAX 


External 
IGGPALT2 
IGGPDGO 
IGGPDGOP 
IGGPEXPD 
IGGPMGO 
IGGPSHNK 
Internal 
IGGPCGO 
IGGPMBGO 
IGGPMVAR 


External Procedures Called 
(Procedures Outside the Module) 


IGGPBMR, IGGPEXT 


IGGPBMR 


IGGPDGO, IGGPDGOP, IGGPGREC, 


IGGPPDE, IGGPPREC, IGGPSMF 
IGGPSCNC 

IGGPGREC 

IGGPRUS, IGGPUPDE 


IGGPGREC, IGGPPREC, IGGPSMFG, 
IGGPTSTS, IGGPXDGO, IGGPXEL2, 


IGGPXLT2 


IGGPAXCI, IGGPGREC 


IGGPGREC 


IGGPPAD, IGGPPUPC, IGGPSMF 


IGGPAXCI, IGGPGREC, IGGPMGO 


IGGPGVAL 


IGGPIGOP, IGGPSGOP 


IGGPAXCI, IGGPGNEX, IGGPGREC 
IGGPAXCI, IGGPDEIN, IGGPGNEX, 


IGGPGREC, IGGPGVAL 


Internal Procedures Called 
(Procedures within the Module) 


IGGPEDS 


IGGPSGOP 


IGGPSFPL 


IGGPSFPL 


IGGPAGOP, IGGPASPT, 
IGGPGNEX, IGGPGREL, 
IGGPIGOP, IGGPMVGO 


IGGPPREC 


IGGPASPT, IGGPGNEX, 
IGGPGREL, IGGPIGOP 


IGGPIGOP 


IGGPMVAR 


— 
— 
— 


IGGPCGO, IGGPDGO, IGGPDGOP 


IGGPMGO 


IGGPEXPD, IGGPMBGO, 
IGGPMGO, IGGPSHNK 
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Calling 
Module and Its 
Procedures 


IGGOCLAY 


Extermal 
IGGPSCNC 
Internal 


IGGPSNVC 


IGGOCLAZ 


External 
IGGPEXT 
IGGPLOC 
Internal 
IGGPSCNF 
IGGPLOC2 
IGGPSHIN 
IGGPGREP 
IGGPUPGD 


IGGOCLAI1 


External 


IGGOCLAI1 


IGGOCLA6 


External 
IGGPBJFB 
IGGPCBPT 
IGGPCRTC 
IGGPDFS2 


Internal 

IGGPCDSD 
IGGPCSDG 
IGGPCSHG 
IGGPDSMD 


IGGOCLA7 


External 
IGGPDEMV 
IGGPDF4T 


IGGPDUSC 
IGGPDVMV 
IGGPMCRA 
IGGPVMSC 


External Procedures Called 
(Procedures Outside the Module) 


IGGPSCNC, IGGPXEXT 


IGGPGREC, IGGPSMFG, IGGPTSTS 
IGGPGVAL 

IGGPGREC 

IGGPGET, IGGPVAL 


IGGOCLC9 


IGGPSALL 


IGGPMOD 


IGGPDLXT, IGGPEXT 


IGGPDLXT, IGGPF4DQ, IGGPF4RD, 
IGGPF4WR, IGGPPUPC 


IGGPDLXT 
IGGPDLXT, IGGPGET 
IGGPGET, IGGPSSCR 


Internal Procedures Called 
(Procedures within the Module) 


IGGPSNVC 


IGGPSCNF 
IGGPSCNF 


IGGPLOC2, IGGPUPGD 
IGGPGREP, IGGPSHIN 


IGGPCDSD, IGGPCSDG, IGGPCSHG 


IGGPDSMD 
IGGPDSMD 


IGGPSET 


IGGPDVMV 


IGGPDEDD, IGGPDESH, 
IGGPDEVG, IGGPDF4T, IGGPDUSC 
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Calling 
Module and Its 
Procedures 


Internal 
IGGPDEDD 
IGGPDESH 
IGGPDEVG 
IGGPSET 

IGGOCLA8& 
External 
IGGPDFRS 
Internal 
IGGPDFRE 

IGGOCLBA 
External 
IGGPGREC 
IGGPGVAL 
IGGPTSTS 
Internal 

ie IGGPCKLC 

IGGPLVAL 
IGGPTCMP 

IGGOCLBB 
External 
IGGPUPDE 


Internal 
IGGPCEXT 
IGGPCSAL 
IGGPMEXT 
IGGPMVOL 
IGGPSSWD 


IGGPUALL 
IGGOCLBC 
External 
IGGPINIT 
IGGPSVOL 
IGGOCLBD 
External 
IGGPALT 


External Procedures Called 
(Procedures Outside the Module) 


IGGPMOD 
IGGPMOD 
IGGPDLXT, IGGPEXT, IGGPMOD 


IGGPGET, IGGPPREC, IGGPSMFG 


IGGPEXT, IGGPGET, IGGPINIT, 
IGGPSMFA, IGGPSMFL, IGGPSVOL, 
IGGPTNXO, IGGPTXO 


ed 


IGGPSALL, IGGPSPAC 
IGGPMOD 

IGGPMOD 

IGGPGET, IGGPINIT, IGGPSVOL 


IGGPGET, IGGPSPAC 


IGGPEXT 
IGGPEXT 


IGGPALVL, IGGPAUPG, IGGPGET, 
IGGPPUPC, IGGPSMF, IGGPSMFA, 
IGGPSMFG 


Internal Procedures Called 
(Procedures within the Module) 


IGGPSET 
IGGPSET 
IGGPDVMV, IGGPSET 


IGGPGREC, IGGPLVAL 
IGGPGVAL, IGGPTCMP 


IGGPCKLC 


IGGPCEXT, IGGPCSAL, 
IGGPMEXT, IGGPMVOL, 
IGGPSSWD, IGGPUALL 


IGGPCEXT, IGGPMEXT, 
IGGPMVOL 


IGGPALMD, IGGPALNM 
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Calling 
Module and Its 
Procedures 


Internal 
IGGPALBT 
IGGPALF1 
IGGPALGV 
IGGPALMD 
IGGPALNM 


IGGPALSV 


IGGOCLBE 


External 
IGGPALEC 
Internal 
IGGPALBC 
IGGPALAE 
IGGPALIX 
IGGPALSA 
IGGPALVA 
IGGPALVL 
IGGPVRD 


IGGOCLBF 


External 
IGGPSSCR 


IGGOCLBG 


External 
IGGPDEL 


IGGPDEXA 
IGGPDLXT 
IGGPDOPN 
Internal 


IGGPERAS 


IGGOCLBH 


External 
IGGPDAVO 
IGGPDEFA 
Internal 
IGGPDAIN 
IGGPDANL 


External Procedures Called 
(Procedures Outside the Module) 


IGGPEXT 
IGGPMOD 


IGGPGET, IGGPPAD, IGGPPDE, 
IGGPSMFR 


IGGPGET 


IGGPEXT, IGGPGET 

IGGPMOD, IGGPSALL 

IGGPEXT 

IGGPALVR, IGGPEXT, IGGPVRD 


IGGPBMR 


IGGPDCLS, IGGPDEAX, IGGPDEMV, 
IGGPDEPT, IGGPDIAX, IGGPDIPT, 
IGGPDUND, IGGPDUPG, IGGPDUSC, 
IGGPDVMV, IGGPGET, IGGPMCRA, 
IGGPSMFS, IGGPVMSC 


IGGPEXT 


IGGPRPLF, IGGPRPLM 


IGGPMOD 


IGGPDUND, IGGPSMFA 


IGGPAXCI 


— 


Internal Procedures Called 


(Procedures within the Module) 


IGGPALGV, IGGPALSV 


IGGPALBT 
IGGPALF1 


IGGPALIX 


— 


IGGPALBC 


IGGPALBC, IGGPALEC 


IGGPALBC, IGGPALAE, IGGPALSA 


IGGPALBC, IGGPALVA 


IGGPVRCV 


IGGPDEXA, IGGPDLXT, 


IGGPDOPN, IGGPERAS 


IGGPDLXT 


IGGPDLXT 


IGGPDAIN 
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Calling 
Module and Its 
Procedures 


IGGOCLBI 
External 
IGGPGET 


IGGPTNXO 


IGGPTXO 


IGGPUCRS 


Internal 


IGGPUCCT 
IGGPUCVT 


IGGPXIO 
IGGOCLBJ 
External 


IGGPGDSP 


Internal 


IGGPGUDS 


IGGOCLBK 


External 


IGGPLDCS 


IGGPLSP 


Internal 


IGGPLBVC 
IGGPLDAS 
IGGPLDCE 
IGGPLEMP 
IGGPLSMP 


IGGPLSMS 
IGGOCLBL 
External 


IGGPDELS 


IGGPDLET 


IGGPDLVM 
IGGPDUCB 


Internal 


IGGPDLCD 
IGGPDLEX 
IGGPDLMF 
IGGPDLSC 
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External Procedures Called 
(Procedures Outside the Module) 


IGGPRAG 


IGGPEXT, IGGPMOD 


IGGPIORA 


IGGPEXT 


IGGPGET 


IGGPGET, IGGPSMFL 


IGGPEXT 


IGGPDBVC, IGGPDF4T, IGGPDLVM, 


IGGPEXT, IGGPFDSP 


IGGPDFM1, IGGPF4RD, IGGPF4WR, 


IGGPGET, IGGPMOD, IGGPDEL, 
IGGPRAOP 


IGGPDVMV 


IGGPEXT 


IGGPLSP 


Internal Procedures Called 
(Procedures within the Module) 


IGGPUCCT, IGGPXIO 


IGGPGET, IGGPUCVT 


IGGPGUDS 


IGGPLBVC 


IGGPLDCE, IGGPLDCS, IGGPLEMP, 
IGGPLSMP 


IGGPLDAS, IGGPLBVC 
IGGPLBVC 


IGGPLBVC 


IGGPDLCD, IGGPDLEX, 
IGGPDLSC, IGGPDLSH, 
IGGPDLVC, IGGPDUCB 
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Calling 
Module and Its 
Procedures 


IGGPDLSD 
IGGDLSH 
IGGPDLVC 
IGGPDLVM 
IGGOCLBM 
External 


IGGPCKAU 


Internal 
IGGPBSGT 
IGGPCKCC 
IGGPCKEX 
IGGPCLGT 
IGGPLVST 
IGGPPWGT 


IGGPPWVR 


IGGOCLBN 
External 
IGGPALVR 
IGGPVRD 
Internal 
IGGPACHR 
IGGPALPL 
IGGPALVE 
IGGPALVO 
IGGPVRCV 

IGGOCLBO 
External 
IGGPRAG 
IGGPRAPA 


IGGPRAPD 


IGGPRAPU 
IGGPRARC 
IGGPRASC 


IGGPXRIO 


External Procedures Called 
(Procedures Outside the Module) 


IGGPMOD 
IGGPMOD 
IGGPEXT 


IGGPINMD, IGGPSPSC 


IGGPGET 
IGGPGET 
IGGPEXT 
IGGPEXT, IGGPGET 


_= 


IGGPGET, IGGPRPLF, IGGPRPLM 
IGGPWTSO 


IGGPALEC, IGGPEXT, IGGPMOD 
IGGPGET 


IGGPGET, IGGPMOD, IGGPPUPC 


IGGPF4DQ, IGGPF4RD, IGGPF4WR 


IGGPPAD, IGGPRAPV 


IGGPRAPV 


IGGPRAPV 


Internal Procedures Called 
(Procedures within the Module) 


IGGPDLET, IGGPDLMF 


IGGPBSGT, IGGPCKCC, 
IGGPCKEX, IGGPLVST, 
IGGPPWGT, IGGPPWVR 


IGGPBSGT, IGGPCKEX 


IGGPBSCGT, IGGPCKEX 


IGGPCKEX 


IGGPBSGT, IGGPCKCC, 
IGGPCKEX, IGGPCLGT 


IGGPALPL, IGGPALVE, IGGPALVO 
IGGPVRCV 


IGGPALPL 


IGGPACHR 


IGGPRAOR, IGGPRAX, IGGPXRIO 


IGGPRAOR, IGGPRAPC, 
IGGPRARA, IGGPRAX 


IGGPRAOR, IGGPRARC, IGGPRAX, 
IGGPXRIO 


IGGPRAOR, IGGPRAX, IGGPXRIO 
IGGPXRIO 


IGGPRAOR, IGGPRARA, 
IGGPRARC, IGGPRAX 


IGGPRAEA 
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Calling 


Module and Its 


Procedures 


Internal 
IGGPRACC 
IGGPRAEA 
IGGPRAOR 
IGGPRAPC 
IGGPRARA 
IGGPRAX 


IGGOCLBP 


External 


IGGPSPAC 


IGGPRETI1 
Internal 
IGGPDALL 
IGGPDEXT 
IGGPGNAM 
IGGPINEX 
IGGPOBTN 
IGGPSRH1 
IGGPSRH2 
IGGPWRIT 


IGGOCLBQ 


External 
IGGPLSTC 


Internal 


IGGOCLBR 


External 


IGGPBMR 


Internal 
IGGPGETM 
IGGPPART 
IGGPPUTM 


IGGOCLBS 


External 
IGGPXEXT 
IGGPXVAL 


Extemal Procedures Called 
(Procedures Outside the Module) 


IGGPEMIO, IGGPEMSG 
IGGPRAOP, IGGPCRAD 


IGGPF4DQ, IGGPF4RD, IGGPF4WR, 
IGGPISCI, IGGPPUPC 


IGGPEXT 
IGGPEXT 
IGGPMOD 


IGGPEXT, IGGPGET 


IGGPGET 


IGGPPUPC 


IGGPBMR, IGGPGREC, IGGPGVAL, 
IGGPSGOP 


Internal Procedures Called 
(Procedures within the Module) 


IGGPXRIO 


IGGPRACC, IGGPRARC, IGGPXRIO 
IGGPRACC 


IGGPDALL, IGGPDEXT, IGGPINEX, 
IGGPOBTN, IGGPSRH1, IGGPSRH2 


IGGPWRIT 


IGGPGNAM 
IGGPGNAM 


IGGPGETM, IGGPPART, 
IGGPPUTM 


IGGPPUTM 


IGGPXVOL 
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Calling 


Module and Its 


Procedures 


Internal 
IGGPXEXS 
IGGPXVOL 


IGGOCLBT 


External 
IGGPXDGO 
IGGPXEL2 
IGGPXLT2 
IGGPXMOD 
Internal 
IGGPCSMP 


IGGOCLBU 


External 

IGGPF4DQ 
IGGPF4RD 
IGGPF4WR 


IGGOCLBV 


External 
IGGPSMFA 


IGGPSMFF 
IGGPSMFL 
IGGPSMFR 
IGGPSMFS 
Internal 
IGGPSMFC 
IGGPSMFD 
IGGPSMFE 
IGGPSMFM 
IGGPSMFP 


IGGOCLBW 


External 
IGGPDEIN 


Internal 


IGGPDOWN 


IGGPRISE 


IGGPSINK 
IGGPSNK2 


External Procedures Called 
(Procedures Outside the Module) 


IGGPGREC, IGGPGVAL 


IGGPADGO, IGGPBMR, IGGPGVAL 
IGGPBMR, IGGPDEL2, IGGPGVAL 
IGGPALT2 


IGGPAOCI, IGGPPUPC 


IGGPGET 


IGGPGET, IGGPLDCS 


IGGPGET 


IGGPGVAL 


IGGPAXCI, IGGPEXPD, IGGPGNEX, 
IGGPGVAL, IGGPPREC, IGGPSHNK 


IGGPAXCI, IGGPGVAL, IGGPPREC, 
IGGPSHNK 


IGGPEXPD, IGGPSHNK 


IGGPAXCI, IGGPGREC, IGGPPDE, 
IGGPPREC 


Internal Procedures Called 
(Procedures within the Module) 


IGGPXEXS 


IGGPCSMP 


IGGPF4DQ 
IGGPF4DQ 


IGGPSMFC, IGGPSMFD, 
IGGPSMFE, IGGPSMFF 


IGGPSMFC 
IGGPSMFC 
IGGPSMFE, IGGPSMFL 


IGGPSMFM 
IGGPSMFP 


IGGPRISE, IGGPSINK, IGGPSNK2 


IGGPSINK, IGGPUPUP 


IGGPDOWN 
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Calling 
Module and Its 
Procedures 


IGGPUPUP 
IGGOCLBX 
External 
IGGPDCIM 
IGGPDSPC 


Internal 
IGGPDCCC 
IGGPDCCI 
IGGPDCID 
IGGPDCIM 
IGGPDCPT 
IGGPDDCE 
IGGPDPBI 
IGGOCLBY 
External 
IGGPDRSP 


Internal 
IGGPDATA 
IGGPDCIS 
IGGPDDRT 
IGGPDDSA 


IGGPDDTC 
IGGPDISA 
IGGOCLBZ 
External 
IGGPCONV 


IGGPGALO 
IGGOCLBO 
External 
IGGPCMKY 
IGGPDCCO 
Internal 
IGGPDCCI 
IGGPOPBI 
IGGOCLB1 


External 


External Procedures Called 
(Procedures Outside the Module) 


IGGPDCCO 


IGGPGET 


IGGPF4RD, IGGPF4WR, IGGPMOD, 
IGGPPUPC, IGGPRCCR, IGGPRPLF, 
IGGPSCAT 


IGGPDSPC 


Internal Procedures Called 
(Procedures within the Module) 


IGGPDCCC, IGGPDCCO, 
IGGPDDCE 


IGGPDCID, IGGPDCIM, IGGPDCPT 
IGGPDPBI 
IGGPDCIM, IGGPMAXA 


IGGPDATA, IGGPDCIS, 
IGGPDDRT, IGGPDDSA, 
IGGPDDTC, IGGPDISA 


IGGPDATA, IGGPDDRT, 
IGGPDDTC 


IGGPGALO, IGGPVALI 


IGGPDCCI 


450 OS/VS2 SVS Independent Component: Virtual Storage Access Method (VSAM) Logic 


Procedure Calls Directory: Catalog Management Modules 


Calling 
Module and Its External Procedures Called Internal Procedures Called 
Procedures (Procedures Outside the Module) (Procedures within the Module) 
IGGPUADD IGGPAXCI, IGGPEXT, IGGPGET, IGGPUCOM, IGGPUEND 
IGGPMOD, IGGPPAD, IGGPPDE 
IGGPUDEL IGGPEXT, IGGPGET, IGGPMOD IGGPUCOM, IGGPUEND 
IGGPPDE 
Internal 


IGGPUCOM IGGPEXT — 
IGGPUEND IGGPGET — 
IGGOCLB2 

External 

IGGPAUPG IGGPEXT,IGGPUADD,IGGPUDEL IGGPAEXA 
Intemal 

IGGPAEXA — —_ 
IGGOCLB3 

External 

IGGPSMF — zs 
IGGPSMFG — _ 
IGGOCLB4 

External 


IGGPDCRA IGGPMDDI, IGGPWCAT, IGGPWCRA IGGPCACB, IGGPCCIO, IGGPCHIU, 
IGGPCI15, IGGPCRPL, IGGPCXWA, 
IGGPDCX!]I, IGGPFMT4, IGGPOCRA, 
IGGPRDEF, IGGPSBAL, IGGPSTRG 


Internal 
IGGPCACB — = 
IGGPCCIO.  — = 
IGGPCHIU. — — 
IGGPCI15 — = 
IGGPCRPL — = 
IGGPCKXWA — — 
IGGPDCXT — —_ 
IGGPFMT4  IGGPF4RD, IGGPF4WR — 
IGGPOCRA — — 
IGGPRDEF IGGPDEFS — 
IGGPSBAL  IGGPSALL — 
IGGPSTRG — IGGPRDEF, IGGPSBAL 
IGGOCLB5 
External 


IGGPDCLS IGGPDLXT, IGGPDUND, IGGPGET, — 
IGGPSMEFS, IGGAVMSC 


IGGPDEAX IGGPDLXT, IGGPGET IGGPDBMD, IGGPDEXB, 
IGGPDIPT, IGGPDUPG 
IGGPDEPT IGGPDLXT, IGGPGET, IGGPPDE, IGGPDBMD 
IGGPSMFS 
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Procedure Calls Directory: Catalog Management Modules 


Calling 
Module and Its External Procedures Called Internal Procedures Called 
Procedures (Procedures Outside the Module) (Procedures within the Module) 
IGGPDIAX IGGPDEXA, IGGPDLXT, IGGPDOPN, IGGPDBMD, IGGPDEXB, 
IGGPGET IGGPDUPG 
IGGPDIPT IGGPDLXT, IGGPGET, IGGPPDE, IGGPDBMD, IGGADEXB 
IGGPSMFS 


Internal 
IGGPDBMD IGGPDLXT, IGGPMOD — 
IGGPDEXB IGGPDLXT, IGGPEXT — 
IGGPDUPG IGGPDLXT, IGGPGET, IGGPUDEL IGGPDEMV, IGGPDVMV 
IGGOCLB6 
External 
IGGPINMD  IGGPGET _ 
IGGPSPSC IGGPGET — 
IGGOCLB7 
IGGPWTSO — IGGPGTSO 
Internal | 
IGGPGTSO  IGGPRPLF, IGGPRPLM 


External 
IGGPRUS IGGPEXT, IGGPGET, IGGPLDC, IGGPFRWK 
IGGPMOD, IGGPSSCR, IGGPTNXO, 
IGGPTXO 
Internal 
IGGPFRWK = IGGPGET, IGGPLOC — 
IGGOCLB8 
External 
IGGPDFBO — — 
IGGPCNBO — — 
IGGPDUND  IGGPGET, IGGPPDE IGGPDEUN 
IGGOCLB9 
External 


IGGPPAIX IGGPDRDA, IGGPDUND, IGGPPSEM IGGPDCBG, IGGPIGDC, 
IGGPMODC, IGGPPRPW, 
IGGPRGBC 


IGGPPATH — IGGPBAMC, IGGPBAWP, 
IGGPCGGC, IGGPIGDC, 
IGGPPRBW, IGGPSCRG, 
IGGPWSMF 


Internal 

IGGPBAMC IGGPMOD — 

IGGPBAWP = IGGPAOCI, IGGPMOD, IGGPPDE IGGPINAE, IGGPINBE 
IGGPCGGC IGGPEXT IGGPEXGC 
IGGPDCBG IGGPDCCE — 

IGGPEXGC IGGPEXT, IGGPGET — 

IGGPIGDC — = 
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Procedure Calls Directory: Catalog Management Modules 


Calling 
Module and Its 
Procedures 


IGGPINAE 
IGGPINBE 
IGGPMODC 
IGGPPRPW 
IGGPRGBC 
IGGPSCRG 
IGGPWSMF 


IGGOCLC9 
External 
IGGOCLC9 
Internal 
BLDCCA 
IGGPRCU 


IGGOCLDA 
External 
IGGPMODI 
IGGPRAPV 


IGGPWCAT 
IGGPWCRA 


External Procedures Called 
(Procedures Outside the Module) 


IGGPEXT 

IGGPAOCI, IGGPGET, IGGPMOD 
IGGPGET, IGGPCKAU 
IGGPMOD 


IGGPSMFA 


IGGPACDV, IGGPRET1 


IGGPCCCR, IGGPEMSG, IGGPRARC, 
IGGPRPLF 


IGGPMOD 


IGGPF4DQ, IGGPF4RD, IGGPF4WR, 
IGGPXIO, IGGPXRIO 


IGGPPAD 
IGGPXRIO 


Internal Procedures Called 


(Procedures within the Module) 


BLDCCA, IGGPRCU 
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Procedure Called-By Directory 


Open/Close/EOV Procedure Called-By 
(Backward-Reference) Table 


Called 

Module Calling Modules 

IDA0192A — 

IDA0192B IDA0192F 

IDA0192C IDA0192A, IDA0192B, IDA0192G, IDA0192V, IDA0200B, 
IDA0200T, IDA0231B, IDA0557A 

IDA0192D IDA0192B, IDA0192V, IDA0200B, IDA0231B, IDA0557A 

IDA0192F IDA0192A 

IDA0192G IFG0195T, SECLOADA 

IDA01921 = 

IDA0192M IDA0192A, IDA0192B, IDA0192F, IDA0192W, IDA0192Y, 
IDA0192Z, IDAOA05B 

IDA0192P IDA0192A, IDA0192B, IDA0192D, IDA0192F, IDA0192G, 
IDA0200B, IDA0200T, IDA0231B, IDA0231T, IDA0557A, IFG0193A, 
IFG0200V, IGC0002C 

IDA0192S IDA0192A, IDA0200B, IDA0231B, IDA0557A 

IDA0192V IDA0192F, IDA0SS7A 

IDA0192W IDA0192Y 

IDA0192Y IDA0192B, IDA0192Z, IDA0200T 

IDA0192Z IDA0192B 

IDA0200B IDA0200T 

IDA0200S _ 

IDA0200T = 

IDA0231B IDA0231T 

IDA0231T a 

IDA0557A ee 

Record Management Procedure Called-By 
(Backward-Reference) Table 

Called 

Module and Its 

Procedures Calling modules 

IDAO19RA IDAOI9RV, IDA019R4 

IDA019RB IDAOI9RA, IDAO19RI, IDA019RO 

IDAO19RC IDAO19RB, IDA019RH, IDAO19RS, IDA019RT, IDAOI9SRV, 

IDAO19RW 
IDAOI9RE IDAOI9RM, IDA019RT 
Procedure 
IDAREPOS IDAOI9RS, IDAO19RT 
IDAOI9RF IDAOI9RE, IDAO19RS, IDA019RT 
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Record Management Procedure Called-By (Backward Reference) Table 


Called 
Module and Its 
Procedures 


IDA019RG 
Procedure 
IDAIST 

IDA019RH 
Procedures 
IDAIVIXB 
IDASPACE 

IDAO19RI 
Procedures 
IDAHLINS 
IDANEWRD 

IDAOI9RJ 
Procedures 
IDAR 
IDAWR 

IDAO19RK 


IDA019RL 
IDA019RM 
Procedure 
IDACHKKR 
IDA019RN 
Procedures 
IDAAQR 
IDAER 
IDA019RO 
IDA019RP 
Procedures 
IDAENDRQ 
IDATJXIT 


IDA019RQ 

IDAOI9RR 
Procedure 
IDARRDRL 

IDAO19RS 
Procedures 
IDAADSEG 
IDAMVSEG 


Calling Modules 
IDAO19RP, IDA0O19SA 


IDAOI9RJ 
IDAOI9RE, IDA019RI 


IDA019RJ, IDAO19RS, IDAOI9RT 
IDAOI9RJ 
IDA019RF 


IDA019SF 
IDA019SF 
IDA019RI 


IDA019RG 
IDA019RG 


IDAOI9RF, IDAO19RN, IDA019RP, IDA019RQ, IDAOI9R1, 
IDA019R4, IDAO19R8, IDAO1I9SA 


IDAO19R4 
IDAOI9RE, IDAO19RF, IDAO19RL, IDA019R4, IDAOL9SF 


IDAO19RS 


IDA019RG, IDAO19RI, IDAO19RJ 
IDAO019RG, IDAO19RJ 
IDAO19R8 


IDA019RX, IDAO19R1 


IDAOI9RE, IDA019RF, IDA0O19RL, IDA019RM, IDA0I9RQ, 
IDAO19RR, IDA019RT 


IDA019RR 
IDAO19R1 


IDA019RQ 
IDAO19RL 


IDAO19RT 
IDAO19RT 
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Record Management Procedure Called-By (Backward Reference) Table 


Called 
Module and Its 
Procedures 


IDAO19RT 
Procedures 
IDADARTV 
IDAJRNSR 
IDASPNPT 

IDA019RU 
Procedure 
IDAXGPLH 

IDAO19RV 
Procedures 
IDAADVPH 
IDARVRS1 

IDAO1I9RW 
Procedures 


IDAABF 


IDAAIBF 
IDAFRBA 
IDAGWSGW 
IDAOI9RX 
Procedures 
IDAGETWS 
IDARELWS 
IDARXBD 
IDAOI9RY 
IDA019RZ 
Procedures 
IDAEXCL 
IDAFREEB 


IDAGNFL 
IDAGNNFL 


IDAGNXT 


IDAGRB 


IDAGWSEG 
IDAMRKBF 


Calling Modules 
IDA0I9SRM 


IDA019R4 

IDAOI9RS 

IDAO19RG, IDAO19RJ 
IDA019RM, IDA019R4, IDA019SA 


IDAOI9RX 
IDAOI9RW, IDA019SF 


IDA019R4 
IDAO19R2 


IDAO19RA, IDAO19RF, IDA0O19RQ, IDAOI9RR, IDAOI9SRT, 
IDAOI9RV, IDA019R4, IDA019R8, IDA019SF 


IDAOI9RF, IDAO1I9RT 

IDAOI9RA, IDAOI9RY, IDA019R2, IDAO19R8 
IDAOIL9RZ 

IDAOI9R1I 


IDA019RU 
IDAO1I9RU 
IDAO019R4 

IDAOI9RZ 


IDAO19R8 


IDAOI9RA, IDA019RB, IDAOISRE, IDAOI9SRF, IDAOI9RG, 
IDAOI9RI, IDAO19RJ, IDAO1I9RK, IDA0N19RO, IDA0N19RQ, 
IDAO19RR, IDAOI9RT, IDAOI9RV, IDAO01I9R1, IDAO19R4, 
IDAO19R8, IDA019SA, IDA019SF 


IDAOI9RE, IDAOIIRG, IDAOI9RI, IDAOISRK 


IDAOI9RF, IDAO19RQ, IDA019R4, IDA019R8, IDAO19SA, 
IDAOI9SF 


IDAOI9RA, IDAOI9RF, IDANI9RQ, IDAOIISRR, IDAOI9RT, 
IDAOISRV, IDA019R4, IDAO19R8 


IDAOI9RA, IDA0I9RB, IDAOI9SRE, IDAOIORF, IDAOI9RI, 
IDAOI9RJ, IDAOI9RO, IDAOI9RR, IDAOISRS, IDAOIORT, 
IDAOI9RV, IDAOISRW, IDAO19R4, IDA019R8, IDAO19SA, 
IDAOI9SF 


IDAOI9RS 
IDAOI9RI1 
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Record Management Procedure Called-By (Backward Reference) Table 


Called 
Module and Its 
Procedures Calling Modules 
IDASBF IDA019RA, IDAO19RE, IDAO19RF, IDA019RP, IDAOI9RS, 
IDAO19RT, IDA019RU, IDA019R1, IDAO19R8, IDAO19SF 
IDASCHBF IDAO19R1 
IDAWAIT IDAO19RA, IDA019RW, IDAOI19RY, IDA019R2 
IDAWRBFR IDAO19RE, IDAO19RF, IDA019RH, IDA019RJ, IDAO19RK, 
IDAO19RP, IDA019RQ, IDAO19RR, IDA019RS, IDAO19RT, 
IDA019RW, IDA019R1, IDA019R4, IDA019R8, IDAO019SA, 
IDA019SF 
IDAWRTBF IDAO19R1 
IDAO019R2 IDA019RZ 
IDAO19R3 IDAON19RW, IDAOI9RY, IDA019R2 
IDA019R4 IDA019RU, IDA019RX, IDAOI19R1 
IDAO19R5 IDAO19RP, IDAO19RY, IDAOI9R1 
Procedures 
IDADRQ IDA019RQ, IDAO19RS, IDAO19RT, IDAO19RU, IDA019RX, 
IDAO19RY, IDAO019R3, IDA019R4, IDAO19R8, IDA019SB 
IDAEOVIF IDAO19RF, IDA019RG, IDAO19RI, IDA0O19RK, IDAO19RN, 
IDA019RQ, IDA019R3, IDA019R8, IDA019SA, IDA019SF 
IDAERROR IDAO19R1 
IDAEXEX IDA019RP, IDAO19RY 
IDAEXITR IDA019RP 
IDARSTRT IDAOI19R1 
IDAO019R8 IDAOI19R1 
IDAO019SA IDA019RM, IDAO19RP, IDAO19RT 
IDA019SB IDA019R3 
IDAO19SF IDA019RF 
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Catalog Management Procedure 
Called-By (Backward Reference) Table 


This table lists procedures (not within the called procedure’s module) that call 
a Catalog Management procedure. In addition to the calling procedures listed, 


a called procedure might be called by procedures within its module. See 
‘Procedure Calls Directory: Catalog Management Procedures”’ to determine 
the calling procedures within the module. 


Called Module 
and its External 
Procedures Calling Procedure (in Module) 
IGGOCLAA 
Procedure: 
IGGPSLEN IGGPSLOC(AM) 
IGGOCLAB 
Procedure: 
IGGPACDV IGGOCLC9(C9) 
IGGOCLAC 
Procedures: 
IGGPDCRC IGGPDCME(AE) 
IGGPMCO IGGPACDV(AB) 
IGGOCLAD 
Procedures: 
IGGPMCO2 IGGPDCOC(AE), IGGPMCO(AC) 
IGGPRAOP IGGPDLET(BL), IGGPRAOR(BO) 
IGGPCRAD IGGPRAOR(BO) 
IGGOCLAE 
Procedures: 
IGGPDCME IGGPDEFC(AS) 
IGGPMEMB IGGPDCSP(AS) 
IGGOCLAF 
Procedures: 
IGGPDELC IGGPCOVR(AT) 
IGGPEMIO IGGPIORA(AG), IGGPRAEA(BO) 
IGGPEMSG IGGPIORA(AG), IGGPRAEA(BO), IGGPRCU(C9) 
IGGOCLAG 
Procedures: 
IGGPAOCI IGGPBAWP(B9), IGGPCSMP(BT), IGGPDCCE(AN), 
IGGPDCPC(AP), IGGPMODC(B9) 
IGGPAXCI IGGPADGO(AW), IGGPAGOP(AW), IGGPDAIN(BH), 
IGGPDEFS(AQ), IGGPDOWN(BW), IGGPMBGO(AX), 
IGGPMVAR(AX), IGGPRISE(BW), IGGPSNK2(BW), 
IGGPUADD(B1) 
IGGPCCCR IGGPDEFC(AS), IGGPDELC(AF), IGGPRCU(C9) 
IGGPIORA IGGPXIO(BI) 
IGGPISCI IGGPDEFS(AQ), IGGPSALL(AR), IGGPSPAC(BP) 
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Catalog Management Procedure Called-By (Backward Reference) Table 


Called Module 
and Its External 
Procedures 


IGGPPAD 


IGGPPDE 


IGGPPLHC 
IGGPPUPC 


IGGPRCCR 

IGGPXIO 
IGGOCLAH 

Procedures: 


IGGPRPLF 


IGGPRPLM 
IGGPSCAT 


IGGOCLAI 
Procedures: 
IGGPDFM1 
IGGPFDSP 

IGGOCLAJ 
Procedure: 
IGGPDBDI 

IGGOCLAK 
Procedure: 
IGGPDCMB 

IGGOCLAL 
Precedures: 
IGGPDEF 
IGGPDTIM 

IGGOCLAM 
Procedures: 
IGGPDBVC 
IGGPSLEL 


IGGPSLOC 
IGGOCLAN 
Procedures: 
IGGPDCCE 
IGGPDRDA 


Calling Procedure (in Module) 


IGGPALNM(BD), IGGPDCCE(AN), IGGPDCPC(AN), 
IGGPDEFS(AQ), IGGPPREC(AW), IGGPRAPA(BO), 
IGGPUADD(B1), IGGPWCAT(DA) 


IGGPALNM(BD), IGGPBAWP(B9), IGGPDELC(AF), 
IGGPDEL2(AV), IGGPDEPT(B5), IGGPDIPT(B5), 
IGGPDUND(B8), IGGPSNK2(BW), IGGPUADD(B1), 
IGGPUDEL(B1) 


IGGPRPLM(AH) 


IGGPALT(BD), IGGPALVE(BN), IGGPCONV(BZ), 
IGGPCSMP(BT), IGGPDF4T(A7), IGGPFDSP(A1), 
IGGPPREC(AW), IGGPPUTM(BR), IGGPSPAC(BP) 


IGGPCONV(BZ) 
IGGPDCPR(AE), IGGPDELC(AF), IGGPRAPV(DA) 


IGGPCONV(BZ), IGGPERAS(BG), IGGPPWGT(BM), 
IGGPRCU(C9), IGGPRCU(C9), IGGPGTSO(B6) 


IGGPERAS(BG), IGGPPWGT(BM), IGGPGTSO(B6) 


IGGPACDV(AB), IGGPCDVR(AT), IGGPCONV(BZ), 
IGGPDEFS(AQ), IGGPDELC(AF) 


IGGPDLET(BL) 
IGGPDELC(AF), IGGPDELS(BL) 


IGGPDSCB(AN) 


IGGPDBDI(AJ) 


IGGPCDVR(AT) 
IGGPDBDI(AJ), IGGPDEFS(AQ) 


IGGPDELC(AP), IGGPDELS(BL) 


IGGPSLCG(AA), IGGPSLEN(AA), IGGPSLR(AA), 
IGGPSLY(AA) 


IGGPACDV(AB) 


IGGPDCBG(B9), IGGPDCPC(AP) 
IGGPAIX(B9) 
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Catalog Management Procedure Called-By (Backward Reference) Table 


Called Module 
and Its External 
Procedures 


IGGPDSCB 
IGGPPSEM 
IGGOCLAP 
Procedure: 
IGGPDCDA 
IGGOCLAQ 
Procedure: 


IGGPDEFS 


IGGOCLAR 
Procedure: 


IGGPSALL 


IGGOCLAS 
Procedure: 
IGGPDEFC 

IGGOCLAT 
Procedure: 
IGGPCOVR 

IGGOCLAU 
Procedure: 
IGGPSALS 

IGGOCLAV 
Procedures: 
IGGPDEL2 
IGGPMOD 


IGGPSGOP 
IGGPUPD 
IGGOCLAW 

Procedures: 
IGGPADGO 
IGGPGNEX 
IGGPIGOP 
IGGPPREC 


Calling Procedure (in Module) 


IGGPDEF(AL) 
IGGPPAIX(B9) 


IGGPDSCB(AN) 


IGGPCDVR(AT), IGGPDSCP(AS), IGGPDSPO(AJ), 
IGGPRDEL(B4) 


IGGPALSA(BE), IGGPCDSD(A6), IGGPCSAL(BB), 
IGGPDCNV(AJ), IGGPDCSP(AS), IGGPDSPO(AJ), 
IGGPSBAL(B4) 


IGGPDCME(AE), IGGPDSCB(AN) 


IGGPACOV(AB) 


IGGPSALL(AR) 


IGGPXEL2(BT) 


IGGPALMD(BD), IGGPALSA(BE), IGGPALVE(BN), 
IGGPALVR(BN), IGGPBAMC(B9), IGGPBAWP(B9), 
IGGPCONV(BZ), IGGPDAVO(BH), IGGPDBMD(BS), 
IGGPDCME(AE), IGGPDEDD(A7), IGGPDESH(A7), 
IGGPDEVG(A7), IGGPDLET(BL), IGGPDLSD(BL), 
IGGPDLSH(BL), IGGPDMOP(AK), IGGPDSMD(A6), 
IGGPFDSP(AI), IGGPMEXT(BB), IGGPMODC(B9), 
IGGPMODI(DA), IGGPMVOL(BB), IGGPRGBC(B9), 
IGGPRUS(B7), IGGPSALL(AR), IGGPTXO(BI), 
IGGPUADD(B1), IGGPUDEL(B1), IGGPWRIT(BP) 


IGGPMGO(AX), IGGPXVAL(B5) 
IGGPACOV(AB) 


IGGPXDGO(BT) 
IGGPDOWN(BW), IGGPMBGO(AX), IGGPMVAR(AX) 
IGGPMGO(AX) 


IGGPDEL2(AV), IGGPDOWN(BW), IGGPGREC(BA), 
IGGPRISE(BW), IGGPSFPL(AV), IGGPSNK2(BW) 
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Catalog Management Procedure Called-By (Backward Reference) Table 


Called Module 
and Its External 
Procedures 


IGGOCLAX 
Procedures: 
IGGPALT2 
IGGPDGO 
IGGPDGOP 
IGGPEXPD 
IGGPMGO 
IGGPSHNK 

IGGOCLAY 
Procedure: 
IGGPSLNC 

IGGOCLAZ 
Procedures: 


IGGPEXT 


IGGPLOC 
IGGOCLA6 
Procedures: 
IGGPBJFB 
IGGPCBPT 
IGGPCRTC 
IGGPDFS2 
IGGOCLA7 
Procedures: 
IGGPDEMV 
IGGPDF4T 
IGGPDUSC 
IGGPDVMV 
IGGPMCRA 
IGGPVMSC 


Calling Procedure (in Module) 


IGGPXLT2(BT) 

IGGPDEL2(AV) 

IGGPDEL2(AV) 

IGGPDOWN(BW), IGGPSINK(BW) 
IGGPAGOP(AW) 

IGGPDOWN(BW), IGGPRISE(BW), IGGPSINK(BW) 


IGGPACOV(AB), IGGPEXT(AZ), IGGPMOD(AV) 


IGGPALGV(BD), IGGPALIX(BE), IGGPALVA(BE), 
IGGPALVL(BE), IGGPALVR(BN), IGGPAUPG(B2), 
IGGPCGGC(B9), IGGPCKEX(BM), IGGPCLGT(BM), 
IGGPDCDS(AF), IGGPDELC(AF), IGGPDELS(BL), 
IGGPDEMV(A7), IGGPDEVG(A7), IGGPDEXA(BG), 
IGGPDEXB(B5), IGGPDLCD(BL), IGGPDLVC(BL), 
IGGPEXGC(B9), IGGPFDSP(AI), IGGPGDSP(BJ), 
IGGPINAE(B9), IGGPINIT(BC), IGGPLDCE(BK), 
IGGPLSTC(BQ), IGGPRUS(B7), IGGPSALL(AR), 
IGGPSALS(AU), IGGPSHR1(B9), IGGPSHR2(BP), 
IGGPSLCG(AA), IGGPSLEL(AM), IGGPSLR(AA), 
IGGPSVOL(BC), IGGPTXO(BI), IGGPUADD(B1), 
IGGPUCOM(B1), IGGPUDEL(B1), IGGPUPDE(BB) 


IGGPACDV(AB), IGGPFRWK(B7), IGGPRUS(B7) 


IGGPDEFS(AQ) 
IGGPDEFS(AQ) 
IGGPDEFS(AQ) 
IGGPDEFS(AQ) 


IGGPDEL(BG), IGGPDUPG(B5) 

IGGPDELS(BL), IGGPDLER(AF) 
IGGPDEL(BG) 

IGGPDEL(BG), IGGPDLVM(BL) 
IGGPDEL(BG) 

IGGPDCLS(B5), IGGPDEL(BG) 
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Catalog Management Procedure Called-By (Backward Reference) Table 


Called Module 
and Its External 
Procedures 


IGGOCLBA 
Procedures: 


IGGPGREC 


IGGPGVAL 


IGGPTSTS 
IGGOCLBB 
Procedure: 
IGGPUPDE 
IGGOCLBC 
Procedures: 
IGGPINIT 
IGGPSVOL 
IGGOCLBD 
Procedure: 
IGGPALT 
IGGOCLBE 
Procedures: 
IGGPALEX 
IGGPALVL 
IGGOCLBF 
Procedure: 
IGGPSSCR 
IGGOCLBG 
Procedures: 
IGGPDEL 
IGGPDEXA 
IGGPDLXT 


IGGPDOPN 
IGGOCLBH 

Procedure: 

IGGPDEFA 


Calling Procedure (in Module) | ) 


IGGPADGO(AW), IGGPAGOP(AW), IGGPGREL(AW), 
IGGPGREP(AZ), IGGPMBGO(AX), IGGPMVAR(AX), 
IGGPSCNF(AZ), IGGPSFPL(AV), IFFPSGOP(AV), 
IGGPSNK2(BW), IGGPXEXS(BS), IGGPXVAL(BS) 


IGGPALT2(AX), IGGPDEIN(BW), IGGPDOWN(BW), 
IGGPLOC2(AZ), IGGPMVAR(AX), IGGPRISE(BW), 
IGGPSCNF(AZ), IGGPUPGD(AZ), IGGPXDGO(BT), 
IGGPXEL2(BT), IGGPXEXS(BS), IGGPXVAL(BS) 


IGGPSFPL(AV) 
IGGPUPD(AV) 


IGGPSSWD(BB), IGGPUPDE(BB) 
IGGPSSWD(BB), IGGPUPDE(BB) 


IGGPCDVR(AT) 


IGGPALVR(BN) 
IGGPALT(BD) 


IGGPRUS(B7), IGGPVMSC(A7) 


IGGPCDVR(AT) 
IGGPDIAX(BS) 


IGGPDBMB(BS), IGGPDCLS(BS), IGGPDEAX(B5), 
IGGPDEMV(A7), IGGPDEPT(B5), IGGPDEVG(A7), 
IGGPDEXB(BS5), IGGPDF4T(A7), IGGPDIAX(BS5), 
IGGPDIPT(B5), IGGPDUPG(B5), IGGPDUSC(A7), 
IGGPMCRA(A7) 


IGGPDCDS(AF), IGGPDIAX(B5), IGGPFDSP(AI) 


IGGPCDVR(AT) 
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Catalog Management Procedure Called-By (Backward Reference) Table 


Called Module 
and Its External 
Procedures 


IGGOCLBI 
Procedures: 


IGGPGET 


IGGPTNXO 
IGGPTXO 
IGGPUCRS 
IGGOCLBJ 
Procedure: 
IGGPGDSP 
IGGOCLBK 
Procedures: 
IGGPLDCS 
IGGPLSP 
IGGOCLBL 
Procedures: 
IGGPDELS 
IGGPDLET 
IGGPDLVM 
IGGPDUCB 
IGGOCLBM 
Procedure: 


IGGPCKAU 


IGGOCLBN 
Procedures: 
IGGPALVR 
IGGPVRD 


Calling Procedure (in Module) 


IGGPALEX(BE), IGGPALIX(BE), IGGPALNM(BD), 
IGGPALT(BD), IGGPALVE(BN), IGGPBSGT(BM), 
IGGPCKCC(BM), IGGPCLGT(BM), IGGPDBBI(AJ), 
IGGPDCLS(B5), IGGPDDCE(BX), IGGPDEAX(B5), 
IGGPDEDE(AL), IGGPDEFS(AQ), IGGPDEL(BG), 
IGGPDELC(AF), IGGPDEPT(B5), IGGPDIAX(B5), 
IGGPDIPT(B5), IGGPDLET(BL), IGGPDSPO(AJ), 
IGGPDUND (BB), IGGPDUPG(BS5), IGGPEXGC(B9), 
IGGPFDSP(AI), IGGPFRWK(B7), IGGPGETM(BR), 
IGGPGREC(BA), IGGPGUDS(BJ), IGGPINMD(B6), 
IGGPISCI(AG), IGGPLSP(BK), IGGPLSTC(BQ), 
IGGPMCRA(A7), IGGPMODC(B9), IGGPPRPW(B9), 
IGGPWGT(BM), IGGPRUS(B7), IGGPSALL(AR), 
IGGPSCAT(AH), IGGPSLCG(AA), IGGPSLR(AA), 
IGGPSLY(AA), IGGPSMFA(BV), IGGPSMFL(BV), 
IGGPSMFM(BV), IGGPSPSC(B6), IGGPSSWD(BB), 
IGGPUADD(B1), IGGPUALL(BB), IGGPUDEL(B1), 
IGGPUEND(B1), IGGPUPDE(BB), IGGPUPGD(AZ), 
IGGPVMSC(A7), IGGPVRD(BM) 


IGGPDSPO(AJ), IGGPRUS(B7), IGGPUPDE(BB) 
IGGPDSPO(AJ), IGGPRUS(B7), IGGPUPDE(BB) 
IGGPRUS(B7), IGGPSCAT(AH) 


IGGPACDV(AB) 


IGGPSMFL(BV) 
IGGPACOV(AB), IGGPDEFS(AQ), IGGPDLMF(BL) 


IGGPCDVR(AT) 

IGGPFDSP(AI) 

IGGPDELS(BL), IGGPFDSP(AI) 
IGGPFDSP(AI) 


IGGPACDV(AB), IGGPCDVR(AT), IGGPDEFS(AQ), 
IGGPPRPW(B9), IGGPSCAT(AH) 


IGGPALVL(BE) 
IGGPALVL(BE) 
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Catalog Management Procedure Called-By (Backward Reference) Table 


Called Module 
and Its External 
Procedures 


IGGOCLBO 
Procedures: 
IGGPRAG 
IGGPRARA 
IGGPRAPD 
IGGPRAPU 
IGGPRARC 
IGGPRASC 
IGGPXRIO 

IGGOCLBP 
Procedures: 
IGGPRET1 
IGGPSPAC 

IGGOCLBQ 
Procedure: 
IGGPLSTC 

IGGOCLBR 
Procedure: 
IGGPBMR 


IGGOCLBS 
Procedure: 
IGGPXEXT 

IGGOCLBT 
Procedures: 
IGGPXDGO 
IGGPXEL2 
IGGPXLT2 

IGGOCLBU 
Procedures: 
IGGPF4DQ 


IGGPF4RD 


IGGPF4WR 


Calling Procedure (in Module) ) 


IGGPGET(BI) 

IGGPPAD(AG) 

IGGPPDE(AG) 

IGGPPAD(AG), IGGPUPC(AG) 
IGGPRCU(C9) 

IGGPISCI(AG) 

IGGPRAPV(DA), IGGPWCRA(DA) 


IGGOCLC%C9) 
IGGPCSAL(BB), IGGPUALL(BB) 


IGGPCDVR(AT) 


IGGPEDS(AU), IGGPSALS(AU), IGGPSSCR(BF), 
IGGPXDGO(BT), IGGPXEL2(BT), IGGPXVAL(BS) ) 


IGGPEXT(AZ) 


IGGPSFPL(AV) 
IGGPSFPL(AV) 
IGGPSFPL(AV) 


IGGPDFMI(AI), IGGPDF4T(A7), IGGPF4PR(AQ), 
IGGPRAPV(DA), IGGPSPAC(BP), IGGPVRCV(BN) 


IGGPCONV(BZ), IGGPDCBO(AE), IGGPDELC(AF), 
IGGPDFMI(AI), IGGPDF4T(A7), IGGPDLET(BL), 
IGGPFMT4(B4), IGGPF4PR(AQ), IGGPRAPV(DA), 
IGGPSPAC(BP), IGGPTMST(AQ), IGGPVRCV(BN) 


IGGPCONV(BZ), IGGPDCBO(AE), IGGPDELC(AF), 
IGGPDF4T(A7), IGGPDLET(BL), IGGPFMT4(B4), 
IGGPF4PR(AQ), IGGPRAPV(DA), IGGPSPAC(BP), 
IGGPTMST(AQ), IGGPVRCV(BN) 
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Catalog Management Procedure Called-By (Backward Reference) Table 


Called Module 
and Its External 
Procedures 


IGGOCLBV 
Procedures: 


IGGPSMFA 


IGGPSMFL 
IGGPSMFR 
IGGPSMFS 


IGGOCLBW 
Procedure: 
IGGPDEIN 

IGGOCLBX 
Procedure: 
IGGPDSPC 

IGGOCLBY 
Procedure: 
IGGPDRSP 

IGGOCLBZ 
Procedures: 
IGGPAUPG 
IGGPCONV 

IGGOCLBO 
Procedures: 
IGGPCMKY 
IGGPDCCO 

IGGOCLB1 
Procedures: 
IGGPUADD 
IGGPUDEL 

IGGOCLB3 
Procedures: 
IGGPSMF 
IGGPSMFG 


IGGOCLB4 
Procedure: 


IGGPDCRA 


Calling Procedure (in Module) 


IGGPALT(BD), IGGPDCOC(AE), IGGPDDMF(AK), 
IGGPDEFA(BH), IGGPUPDE(BB), IGGPWSMF(B9) 


IGGPLSP(BK), IGGPUPDE(BB) 


IGGPALNM(BD) 


IGGPDCLS(B5), IGGPDEL(BG), IGGPDEPT(BS), 


IGGPDIPT(BS) 


IGGPMVAR(AX) 


IGGPDCCO(BO), IGGPDRDA(AN) 


IGGPDRDA(AN) 


IGGPALT(BD) 
IGGPCOVR(AT) 


IGGPDRPG(AL) 
IGGPDSPC(BX) 


IGGPAUPG(B2), IGGPDBDI(AJ) 
IGGPAUPG(B2), IGGPDUPG(B5) 


IGGPALT(BD), IGGPDEL2(AV), IGGPPREC(AW) 
IGGPALT(BD), IGGPDEL2(AV), IGGPGREC(BA), 


IGGPSCNF(AZ) 


IGGPDEFS(AQ) 
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Catalog Management Procedure Called-By (Backward Reference) Table 


Called Module 
and Its External 
Procedures 


IGGOCLBS5 
Procedures: 
IGGPDCLS 
IGGPDEAX 
IGGPDEPT 
IGGPDIAX 
IGGPDIPT 
IGGPDUPG 

IGGOCLB6 
Procedures: 
IGGPINMD 
IGGPSPSC 
IGGPWTSO 

IGGOCLB7 
Procedure: 
IGGPRUS 

IGGOCLB8 
Procedures: 
IGGPCNBO 
IGGPDFBO 
IGGPDUND 


IGGOCLC9 
Procedure: 
IGGOCLC9 

IGGOCLDA 
Procedures: 
IGGPMODI 
IGGPRAPV 
IGGPWCAT 
IGGPWCRA 


Calling Procedure (in Module) 


IGGPDEL(BG) 
IGGPDEL(BG) 
IGGPDEL(BG) 
IGGPDEL(BG) 
IGGPDEL(BG) 
IGGPDEL(BG) 


IGGPCKAU(BM) 
IGGPCKAU(BM) 
IGGPPWET(BM) 


IGGPUPD(AV) 


IGGPDSPO(AJ) 
IGGPDBOI(AJ) 


IGGPDCBO(AE), IGGPDCLS(B5), IGGPDEFA(BH), 
IGGPDEL(BG), IGGPPAIX(B9) 


IGGOCLAI(A1) 


IGGPDCRA(B4) 


IGGPRAPA(BO), IGGPRAPD(BO), IGGPRAPU(BO) 


IGGPDCRA(B4) 
IGGPDCRA(B4) 
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DATA AREAS 


VSAM Data-Set Format 


VSAM Record 


Control Interval 


‘Data Areas” describes the VSAM data set, index, and catalog and their 
record formats. 


‘“‘Data Areas”’ also describes each VSAM control block and shows the 
relationships between VSAM control blocks. OS/VS1 VSAM Cross 
Reference has a ‘“‘Symbol Where Used Report”’ that lists alphabetically all the 
symbols used in VSAM modules, along with all the modules that use them. 


A VSAM data set is a collection of records grouped into control intervals. 
Control intervals are grouped into larger units called control areas. The 
VSAM stored record, control interval, and control area are described in the 
topics that follow. 


VSAM records are ordered according to key, in the case of a key-sequenced 
data set, according to when the records were stored, in the case of an 
entry-sequenced data set, or according to record numbers that serve as keys 
in the case of a relative record data set. 


Data records are put in the low-address portion of the control interval. 
Control information about each data record is put in the high-address portion 
of the control interval. The combination of a data record and its control 
information, through they are not physically adjacent, is called a stored 
record. 


In a key-sequenced or entry-sequenced data set, records can be variable in 
length and can span control intervals. Each segment of a spanned record is 
stored in its own control interval. 


A control interval is a continuous area of auxiliary storage that VSAM uses 
for storing records. The control interval is the unit of information that VSAM 
transfers between virtual and auxiliary storage. 


The length of each control interval is an integral multiple of blocksize. The 
size of a control interval is determined by the system from the size of the 
records, user-specified minimum buffer size, device characteristics, and the 
user-specified percentage of free space. The user can specify the size of the 
control interval, but it must be within limits acceptable to VSAM. 


Figure 52 shows the format of a control interval. 
When a VSAM data set is created, records are put into control intervals. 


For an entry-sequenced data set, records are ordered according to when they 
were stored in the data set. The first record to be stored, therefore, has the 
lowest RBA. A control interval is filled until there is insufficient space in it for 
the next record. Records are always added at the end of an entry-sequenced 
data set. 


For a key-sequenced data set, records are ordered according to key. Records 
of a key-sequenced data set are put into control intervals; the percentage of 
free space specified is reserved in each control interval and in each control 
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Record 
n 


Free Space 


Figure 52. Control Interval Format 


area for use by records to be added to the data set. As records are added to 
the data set, records that have higher keys.are moved to higher RBA 
locations; the free space within the control interval is reduced. 


Distributed free space is used to simplify the insertion of records. If there is 
enough free space in the control interval to accommodate the record to be 
inserted, higher-keyed records are moved within the control interval to keep 
the records in key sequence. 


If the space needed for directly inserted records is greater than the amount of 
free space available in a control interval, the control interval is split: VSAM 
moves some of the stored records (data records and their control information) 
to an empty control interval in the same control area. For mass insert 
(sequential insert at the end of a control interval), the percentage of free 
space defined by the user is maintained. When a control interval has reached 
its defined packing factor, a new control interval is obtained. No data records 
are moved. 


Note that it is possible for the physical sequence of records to be different 
from their key sequence after control interval splits. The sequence will be 
accordin g to key in each control interval, but the control intervals involved in 
the split need not be adjacent. Thus, it is possible to have 1-2-3, 4-5-6, 9-10, 
7-8 in each of four control intervals. The sequence-set index records, 
however, reflect the key sequence. 


For a relative record data set, records are ordered according to their relative 
record number. Each control interval has as many fixed-length slots as will fit 
(and allow room for control information.) If each control interval has ten 
slots, the first control interval has slots for relative records 1 through 10, the 
second for 11 through 20, and so on. 
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RDF—Record Definition Field 


The Record Definition Field (RDF) describes a record, record slot, or record 
segment within the control interval. RDFs are put into the control interval 
right to left so that the rightmost RDF describes the leftmost data record. The 


format of the RDF is: 
Bytes and 
Offset Bit Pattern 
0(0) | 
Kuli 
XX 
ee oe 
X.....XX 
1(1) 2 


Description 
Control field: 


Indicates whether there is (1) or isn’t (0) a paired RDF to the 
left of this RDF. 

Indicates whether the record spans control intervals: 

00 No. 


01 Yes—this is the first segment. 
10 Yes—this is the last segment. 
11 Yes—this is an intermediate segment. 


Indicates what the 2-byte binary number that follows this 
control field gives: 


0 The length of the record, segment, or slot 
described by this RDF. 
1 The number of consecutive unspanned 


records of the same length, or the update 
number of the segment of a spanned record. 
For a relative record data set, indicates whether the slot 
described by this RDF does (0) or doesn’t (1) contain a 
record. 
Reserved. 


Binary number: 


° When bit 4 in the control field is 0, gives the 
length of the record, segment, or slot 
described by this RDF. 

° When bit 4 in the control field is 1 and bits 2 


and 3 are 0, gives the number of consecutive 
records of the same length. 

° When bit 4 in the control field is 1 and bits 2 
and 3 aren’t 0, gives the update number of 
the segment described by this RDF. 
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CIDF—cControl Interval Definition Field 


The Control Interval Definition Field (CIDF) describes the control interval. 
The format of the CIDF is: 


Bytes and 

Offset Length Description 

0(0) Zz The displacement from the beginning of the control interval 
to the beginning of the unused space, or, if there is no unused 
Space, to the beginning of the control information. This 
number is equal to the length of the data (records, record 
slots, or record segment). In a control interval without data, 
the number is 0. 

2(2) 2 The length of the unused space. This number is equal to the 


length of the control interval, minus the length of the control 
information, minus the 2-byte number in the preceding field. 
In a control interval without data (records, record slots, or 
record segment), the number is the length of the control 
interval, minus 4 (the length of the CIDF—there are no 
RDFs). In a control interval without unused space, the 
number is 0. 


In an entry-sequenced data set, when there are unused control intervals 
beyond the last one that contains data, the first of the unused control 
intervals contains a CIDF filled with Os. In a key-sequenced or relative record 
data set, or a key-range portion of a key-sequenced data set, the first control 
interval in the first unused control area (if any) contains a CIDF filled with 
Os. A control interval with such a CIDF contains no data or unused space. 


Control Area 


A control area consists of control intervals; the number of control intervals in 
a control area is determined by VSAM. The control area is the amount of 
space that VSAM preformats so that data integrity is ensured for records 
added to a data set. 


Control areas are also used to simplify and localize the movement of records 
when records are inserted in a key-sequenced data set. If an insertion requires 
a free control interval and there isn’t one, a control-area split results. VSAM 
establishes a new control area and moves the contents of approximately half 
of the full control area to free control intervals in the new control area. The 
new records, as their keys dictate, are then inserted into one of the two 
control areas. 


Index Format 


There are two types of indexes in VSAM: the prime index of a 
key-sequenced data set, and alternate indexes of either a key-sequenced or 
an entry-sequenced data set. 


A key-sequenced data set is a cluster composed of a data component, which 
contains the control intervals that contain data records, and an index 
component, which contains the control intervals that contain the records of 
the prime index. 


An alternate index is itself a key-sequenced data set. Its data component 
contains index records that give the location of data records within its base 
cluster (the key-sequenced or entry-sequenced data set for which it is the 
alternate index). 
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J 


Format of Records in a Prime Index 


The format of records in the index component of key-sequenced cluster is 
fully compatible with the format of data records; that is, index records, 
regardless of their level within the index, are treated by record-management 
modules in the same way that any other VSAM record is treated. Each index 
record and associated control information resides in an index control interval. 
Figure 53 shows the basic format of an index control interval. The RDF and 
CIDF fields are described under ‘‘Control Interval” earlier in this chapter. 


Control Information 


Index Record 


Figure 53. Index Control! Interval Format 


Figure 54 shows an expansion of the record portion of the index control 
interval. 


Free Data- Index 
Control- Entries 
Interval 

Pointers 


Figure 54. Index Record Format 


The header portion of the index record contains, for example, the information 
required to insert index entries, to locate entries within the index record, and 
to convert pointers within entries to RBAs. The free data-control interval 
pointers are used to locate data control intervals that have not yet been used; 
these entries exist only in sequence-set index records. Both the index entries 
and the free data-control interval pointers are placed in the index record from 
right to left, as indicated in the figure. 


Index entries are grouped into sections. When an index entry is to be located, 
the search for it begins at the section level. The high-key entry of each section 
is examined to locate the section that contains the specified entry. VSAM 
determines the number of sections on the basis of the total number of entries 
within the index record. Figure 55 shows the index entry portion of the index 
record divided into sections. 


The parts of an index record—header, free data-control interval pointers, and 
entry sections—are described in the paragraphs that follow. 
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Inde. Entries : Index Entries ‘ Index Entries 


Figure 55. Index Entries Grouped into Sections 


Index Record Header 


The format of the index record header is: 


Bytes and 

Offset Bit Pattern Field Name Description 

0 (0) 2 IXHLL Length, in bytes, of the index record, 
including this field. 

2 (2) I IXHFLPLN Length, in bytes, of the control information 
(the IBFLPF, IBFLPL, and IBFLP3 fields) in 
each index entry. 

3 (3) I IXHPTLS ILength of the vertical pointers in this index 


record. In the sequence set, vertical pointers 
point to control intervals in the data 
component; in the index set, they point to 
control intervals in a lower level of the 
index.! This field is used as a mask for insert 
character (store character) under mask 
instructions that are used to access pointers. 
The value contained in this field specifies the 
length of these pointers, as follows: 


X‘Ol’ 1-byte pointer 
X*03’ 2-byte pointer 
X‘07’ 3-byte pointer 


4 (4) 4 IXHBRBA For a sequence-set index record, the RBA of 
a data control area that contains data to be 
referenced. This RBA and index-entry 
pointers are used together to calculate the 
4-byte RBA of another index record or of a 
data control interval. 


8 (8) 4 IXHHP Pointer to the logically next index record in 
this index level. (Horizontal pointer.) 

12 (C) 4 IXHXX Reserved (0). 

16 (10) l IXHLV Index level number. A sequence-set index is 


assigned a value of 1; the next higher-level 
index is assigned a value of 2; etc. 


17 (11) 1 IXHFLGS Reserved (0). 


18 (12) 2 IXHFSO Displacement from the beginning of this 
record to the space available for inserting 
index entries. For higher-level indexes, the 
entry space immediately follows the record 
header; for sequence-set indexes, the entry 
space follows the record header and free 
data-control interval pointers. 
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Index Record Header Format 


Bytes and 
Offset Bit Pattern Field Name Description 
20 (14) 2 IXHLEO Displacement from the beginning of this 
record to the last (high-key) section entry in 
the index record (the leftmost entry).2 
22 (16) Z IXHSEO Displacement from the beginning of this 


record to the first (low-key) section entry in 
the index record (the leftmost entry in the 
rightmost section).2 
1 Pointers are allowed to vary in length to conserve index space. If, for example, the number of items to be 
referenced by an index record is less than 256, a one-byte pointer can be used; if the number is greater than 


256 and less than 65,536, a two-byte pointer can be used; and if the number is greater than 65,536, a 
three-byte pointer can be used. 


2 This displacement is to the IBFLPF (front-key compression count) byte of the entry, not to the beginning of 
the entry. 


Free Data-Control-Interval Pointers 


Index Entries 


Free data-control interval pointers, which exist only in sequence-set index 
records, are used to calculate the RBAs of available data control intervals. 
The length of a pointer is specified in the record header. 


VSAM always uses the rightmost free data-control interval pointer when a 
data control interval is needed. The value of the pointer is set to 0 when the 
control interval is used. As pointers are set to 0, the displacement to space 
that is available for index entries (contained in the record header) is adjusted 
by the length of the free data-control interval pointer. In this way, space used 
by free data-control interval pointers is made available for index entries when 
the pointers are no longer required. 


The format of an index entry is: 


Length 

(in Bytes) Field Name Description 

Variable IXKEY Key characters that determine the sequence of 
records in a key-sequenced data set. 

1 IBFLPF Front-key compression count, that is, the number of 
characters by which the beginning of the key has been 
compressed. 

| IBFLPL Length of the IXKEY field. 

1-3 IBPLP3 Pointer to an index or data control interval. The 


length of the pointer is specified in the record header. 
The last (high key) index entry in each index level is a dummy entry: it 
contains no key characters and the IBFLPF and IBFLPL fields are set to 0. 
The pointer in this entry is used to calculate the RBA of the last control 
interval in the logically next lower index level. 


Each segment of a spanned record has its own entry in a sequence-set index 
record. Only the leftmost entry (the entry for the last segment) contains the 
IXKEY field. In all of the other entries, IBFLPF contains the spanned 
record’s key length, and IBFLPL contains 0. 
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Index-Entry Sections 


Index entries are grouped into sections. A section is defined by a 2-byte field 
that precedes the high-key index entry. This 2-byte field links a section with a 
higher-keyed section. This field contains the displacement from the IBFLPF 
field of the high-key entry in this section to the IBFLPF field of the high-key 
entry in the next higher-key section. Figure 56 shows how these pointers 
work. Section 1 indicates the number of bytes between the high-key entry in 
section 1 and the high-key entry in section 2; section 2 indicates the number 
of bytes between the high-key entry in section 2 and the high-key entry in 
section 3; etc. 


When the index is searched, the high key of each section is examined to locate 
the section that contains the specified entry. When the section that contains 
the entry is found, it is searched. 


When an index is originally built, the sections within a record usually contain 
the same number of entries. As index entries are added and deleted, however, 
the number of entries per section varies. 


All of the entries for the segments of a spanned record are grouped into the 
same section. 


Format of Records in an Alternate Index 


The index component of an alternate index is the same as the index of any 
key-sequenced data set. The data component, too, is the same in form: data 
records, which can be spanned, are stored in control intervals, and control 
intervals are grouped into control areas. 


A data record in an alternate index contains: 
e Header information 


« A key field that contains the alternate key of the base cluster over which 
the alternate index is defined 


e One or more pointers to data records in the base cluster that contain the 
alternate key in the alternate-index record’s key field 


In an alternate index defined with unique keys, data records are fixed in 
length—they contain only one pointer to a base record. In an alternate index 
defined with nonunique keys, data records are variable in length—they can 
contain more than one pointer to base records. 


A pointer to a record in an entry-sequenced base cluster is an RBA pointer. 
It gives the location of the base record by RBA. A pointer to a record ina 
key-sequenced base cluster is a prime-key pointer. That is, it identifies the 


Header 
Pt fp Pp 
Index Sections of index entries 


record 
header 


Figure 56. Index-Entry Section Pointers 
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Cc 


Catalog 


base record by its prime key. VSAM uses the prime-key pointer to go to the 
index of the key-sequenced base cluster to find the base record’s location. 


The format of a data record in an alternate index is: 


Bytes and 

Offset Bit Pattern Field Name Description 

Header 

0(0) 1 AIXFG Flags that indicate what kind of pointer(s) the 
record contains: 

0 RBA pointer(s). 
| Prime-key pointer(s). 
XXXX XXX. Reserved. 

1(1) | AIXPL Length of a pointer. An RBA pointer is four 
bytes long. A prime-key pointer is as long as the 
prime key of the key-sequenced base cluster. 

2(2) Z AIXPC Number of pointers in the record. 

4(4) 1 AIXKL Length of the key field in the record. The length 
is the same as the length of the alternate key 
field in base records. (That is, the key field in an 
alternate-index record is not compressed.) 

Key Field 

5(5) VL AIXKY The key field of the record. It contains the 
alternate key of the base record(s) governed by 
the record. 

Pointer(s) 

VL VL AIXPT A pointer to a base record. This field is repeated 


for each base record that contains the alternate 
key in AIXKY. 


VSAM catalogs—the master catalog and any user catalogs—are built and 
processed by catalog management modules. Catalog management modules, 
via the catalog, enable a user to locate a data set, volume, index, or cluster by 
specifying a dsname or volume serial number. In addition, VSAM catalogs 
provide VSAM with the information required to allocate space for data sets, 
verify authorization to gain access to them, compile usage statistics on them, 
and relate RBAs to physical locations within data sets. The catalog indicates, 
therefore, much more than the simple location of data sets. The catalog 
maintains the relationship between a key-sequenced data set and its index, 
describes the location of VSAM data spaces and the data sets that reside in 
them, and describes the space that is available for new data sets. 


The VSAM catalog is conceptually a key-sequenced VSAM data set divided 
into two key ranges called the low-address range and the high-address range. 
VSAM data set processing options, such as index record replication and 
sequence set with data, are utilized in both parts of the catalog. The catalog 
record size is variable; the catalog control interval size is 512 bytes. Figure 57 
shows a VSAM catalog. The figure shows: 


e The low-address range of the catalog, shown on the left, contains records 
that describe objects—data sets, indexes, alternate indexes, paths, upgrade 
sets, volumes, and clusters. 


e The high-address range of the catalog, shown on the right, contains the 
true name (a data-set name, cluster name, or volume serial number) of an 
object specified by the user. 
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e The index, shown in the middle, points to both the low- and high-address 
parts of the catalog. 


Low-Key Range High-Key Range 
(Catalog Records) (True-Name Entries) 


Figure 57. Parts of a VSAM Catalog 


With the exception of catalog records that are built when the catalog is 
created and describe the catalog itself, catalog records are built as objects are 
cataloged. The order the records are in depends upon which portion of the 
catalog the records belong to. If the catalog records reside in the low-address 
part of the catalog, the records are ordered according to control interval 
number. As objects are cataloged, available control intervals are used. If the 
catalog records reside in the high-address part of the catalog, they are ordered 
according to their true name (data-set name or volume serial number). 


Catalog management relies on VSAM record management for all record 
retrieval and storage. When a user specifies, a data-set name, the index points 
to a catalog record in the high-address part of the catalog that contains the 
data-set name; that record, in turn, contains the control interval number of 
the catalog record that describes the data set. Catalog management converts 
the control interval number to an RBA in the low-address part of the catalog. 


High-Address Range of the Catalog 


The high-address range of the catalog contains 47-byte True Name records in 
512-byte control intervals. The True Name records associate user-specified 
names or volume serial numbers with the control interval number of the 
catalog record that describes the specified object. 
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Low-Address Range of the Catalog 


Records in the low-key range are 505 bytes long. Each record resides in its 
own control interval. Each record also identifies its record type. The low-key 
range of the catalog is made up of the following types of records: 


Control record, which describes the free control intervals in the 
low-address part of the catalog. The Control record is always the fourth 
record in the catalog. This record is record type ‘“‘L.”’ 


Free record, which marks the control interval in which it resides as 
available for use as another kind of catalog record. There is one Free 
record for each previously assigned control interval that is available for 
use. This record is record type ‘‘F.”’ 


Cluster record, which describes a VSAM data-set cluster. This record 
contains the control interval number of a Data record and, if the VSAM 
data set is a key-sequenced data set, the control interval number of an 
Index record. There is one Cluster record for each VSAM cluster 
cataloged. This record is record type “‘C.”’ 


Alternate index record, which relates the alternate index to its associated 
base cluster and also to any paths over it. This record is record type “‘G.”’ 


Data and Index records, which describe data sets and indexes. There is one 
Data or Index record for each data set or index cataloged. These records 
are record types ““D” and “‘T.”’ 


Path record, which relates a base cluster and possibly an alternate index. 
This record is record type “‘R.” 


Upgrade set record, which relates the data components and index 
components of the alternate indexes that make up the upgrade set. This 
record is record type ‘““Y.” 


NonVSAM record, which describes a data set organized differently than 
VSAM. There is one NonVSAM record for each nonVSAM data set 
cataloged. This record is record type ‘‘A.”’ 


User-Catalog record, which describes a VSAM user catalog. There is one 
User-Catalog record for each user catalog connected to this master catalog. 
This record is record type ‘‘U.”’ 


Volume record, which describes each VSAM data space on a volume, the 
data sets that reside in the data space, and the space available within the 
data space. There is one Volume record for each volume controlled by this 
catalog. This record is record type ‘“‘V.” 


Extension record, which contains overflow information from another 
catalog record. There are as many Extension records as are required to 
contain overflow information. This record is record type ““W”’ when it is an 
extension of a Volume record; it is record type “‘E”’ when it is an extension 
of any other catalog record. 


The Cluster, Data, Index, Alternate Index, Path, Upgrade, NonVSAM, 
Extension, and User-Catalog records have a common general format. Figure 
58 shows the general format for these records. 
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0(0) 1(1) 4(4) 5(S) 11(B) 14(E) 18(12) 22(16) 26(1 A) 


po | oo RELIND | CRAVOL | CRAIDNO | CRADEVT | CRACRETS | CRADITS j Reened | | 


For recoverable 
catalogs, the 
data or index 
creation time- 


Identifies the releases 
0 = Nonenhanced 
VSAM 
Enhanced 

VSM 


stamp. Zeros 
for other record 
types. 


For recoverable 
caralogs, identifies 
the CRA volume 


For recoverable 
catalogs, the CRA 

creation time-stamp. 
serial number. 


For recoverable 
catalogs, indicates 
the CRA control 
interval number. 


For recoverable catalogs, 
the CRA device type (same 
as UCB device type field, 
except (1) shared bit is 
turned off, (2) RPS bit is 
turned off (3340 only), 
and (3) power warning 

bit is turned off. 


! Contains zeros if the catalog is not recoverable or if there is no associated CRA entry. 


Figure 58 (Part 1 of 2). Catalog Record—General Format 
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Identifies the type 

of catalog record: 

Non VSAM 
Cluster 

Data 

Free 

Alternate Index 
Index 
Extension 

Path 
User-catalog 
Volume 
Extension for a 
volume record 
Upgrade Set 


A 
C 
D 
F 
G 
I 
E 
P 
U 
V 
W 


as 


5 Bytes 1 Byte 


Number of 
Sets of 
Fields 


t Horizontal 
Extension 


ASPT (Available- 
Space Pointer) 


k——____— Header Fields — ca. °° = 
44(2C) 45(2D)  47(2F)48(30) 49(31) 93(5D) 


Size 


Length (in bytes) 
to the End of the 
Fixed-Length 
Fields 


Fixed-Length 


Variable-Length 


Fields Fields 


Count of 
Variable- 
Length 
Fields 
(usually 
zero) 


Since there are usually no Variable- 
Length Fields, ‘‘L” points to the 
Horizontal-Extension-Record Pointer. 


5 Bytes 5 Byte Pointers (*) Variable-Length Sets of Fields 


Set-of-Fields Pointers Sets of Fields 


The set of Number of T 

fields is Rewsea Bytes from ( oe ) Sequence 

in this the First =a ee Number 

record. Set of Fields 

The set of | (3) (1) 

fields is hea Type Sequence Number of Length of the 

in an nterva (group) Number Variable- Fixed-Length Fields— 
rie Number Code Length this includes the “C” 
record. 


Fields and “L”’ Bytes 


Bit 0 


= Q: Set of fields in record 


1: Set of fields in extension 
Bit 1 = 1: Inactive set-of-fields pointer 


Bits 2-7: Type (group code) 


Each Variable-Length Field: 


(2) 
Length 


*The volume catalog record and its 
extension (types V and W) have 6-byte 


set-of-fields pointers, because of 
2-byte sequence numbers. 


Figure 58 (Part 2 of 2). Catalog Record—General Format 
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Sets of Fields in the Catalog Records 


Related fields of information are grouped into sets of fields so they can be 

treated as a unit. For example, all fields relating to one volume on which a ; 
data set resides are grouped together. If a data set resides on three volumes, J 
there are three sets of volume information; these sets of volume information 

fields are not necessarily contiguous. Each pointer to a set of fields, however, 

contains a code that identifies the kind of information the set of fields 

contains. It is possible for one record to contain many sets of fields. 


C37? 
Alternate Index 


“—P” 
Alternate Index 
Data 


Following are the sets of fields that can occur in Cluster, Alternate Index, 
Path, Upgrade, Data, Index, NonVSAM, and User-Catalog records: 


Alternate Index* 


AMDSB (Access Method Data Set Statistics Block), which appears in Data 
Set and Index records. Only one copy of an AMDSB appears in a record. 
A pointer to AMDSB information contains a code of 1. 


Association information, which appears in Data, Index, Cluster, Alternate 
Index, Path, and Upgrade catalog records. Figure 59 illustrates the 
associations that can occur in these records. Each arrow represents an 
association. Associations shown by a broken line exist only when the base 
cluster is a key-sequenced data set. Multiple alternate indexes and paths 
may exist. 


Volume information, which appears in Data, Index, User-Catalog and 
NonVSAM records. This set of fields describes all of the direct-access 


“sR” 
Alias Path 


ae Gad 
Base Cluster 


rr ae ll 


| 
sees 


er Gig 


ed Kae 


xe DD aie 


Index Base Data Base Index 


ia eas 
Upgrade* 


* The alternate index is in the upgrade set; therefore, the “Y” entry has associations pointing 


to the data and index of the alternate index. 


Figure 59. Catalog Record Associations 


480 OS/VS2 SVS Independent Component: Virtual Storage Access Method (VSAM) Logic 


device space allocated to the data set (or index, etc.) on a particular 
volume. A separate set of volume information fields is used to describe the 
space on each volume. If the data set’s space on a volume is divided into 
key ranges, each key range is described in a separate set of volume 
information fields. As many sets of volume information fields as are 
required to describe allocated space can appear. A pointer to volume 
information contains a code of 3. 


Password information, which can appear in Data, Index, Alternate Index, 
Path, and Cluster records. This set of fields contains the security 
information for a data set (or index, etc.). Only one set of password 
information fields can appear. A pointer to password information contains 
a code of 4. 


The Volume record can also contain sets of fields, as follows: 


Track allocation information (Space Map set of fields). This set of fields 
describes each track on the volume as allocated to a VSAM object or 
unallocated. Each volume record contains as many of these sets of fields as 
are required to describe the entire volume. A pointer to track allocation 
information contains a code of 5. 


VSAM data space information (Data Space Group set of fields). This set 
of fields describes a VSAM data space on the volume. One set of fields is 
required to describe each data space and its extents on the volume. A 
pointer to data-space information contains a code of 6. 


Data Set Directory Entry set of fields. This set of fields describes a data set 
that resides in a VSAM data space. One set of fields is required for each 
data set. A pointer to data set information contains a code of 8. 


Note: If a Cluster, Alternate Index, Upgrade, Data, Index, NonVSAM, or 
Volume record is extended, these sets of fields (except for the AMDSB set of 
fields) are moved, as required, into an Extension record. 


Catalog Records that Describe the Catalog 


Catalog records that describe the catalog as a data set are in fixed positions at 
the beginning of the catalog. The following table shows the control interval 
numbers of records that describe the catalog, the kind of catalog record each 
is, and the contents of each. 


Control 

Interval Record 

Number Type Contents 

0 Data Description of the data portion of the catalog. 

| Index Description of the index portion of the catalog. 

P Cluster Description of the catalog cluster. 

3 Control Catalog control record (CCR), which describes the 
catalog’s free control intervals. 

4 Extension Extension of the index catalog record (control interval 


number 1). This Extension record contains a description 
of the high-level index extents of the catalog. 
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Catalog Records that Describe the Catalog 


Control 

Interval Record ) 
Number Type Contents 

5 Extension Extension of the data catalog record (control interval 


number 0). This Extension record contains a description 
of the low-address data extents of the catalog. 


6 Extension Extension of the index catalog record (control interval 
number 1). This Extension record contains a description 
of the low-address index sequence set extents of the 
catalog. 


7 Extension Extension of the data catalog record (control interval 
number 0). This Extension record contains a description 
of the extents of the True Name records in the 
high-address part of the catalog. 


8 Extension Extension of the index catalog record (control interval 
number 1). This Extension record contains a description 
of the high-address index sequence set extents of the 
catalog. 


9 Volume Description of the track allocation and VSAM data spaces 
on this volume. 


10-13 Volume As many volume extension records as are necessary to 
describe the total space on the volume. 


When the catalog is built, there are two True Name records. One contains the 
catalog volume’s serial number and points to control interval number 9. The 
other contains the catalog’s name and points to control interval number 2. 


Locating Fields in Catalog Records J 


A field-name dictionary, which is part of the catalog management code, 
allows catalog management to locate fields within catalog records by name. 
The dictionary also allows for combination field names—each combination 
field name allows catalog management to locate a group of related fields. 


Catalog records and the field-name dictionary are described in the topics that 
follow. 


Recoverable Catalog Support 


Catalogs can be defined with an optional recovery attribute that allows data 
sets to be recovered or restored. Recovery is based on information that is 
recorded in the catalog and also in a catalog recovery area on the volumes 
owned by the catalog. The recovery area is established when the recoverable 
catalog acquires ownership of the volume. Thus, all volumes owned by a 
recoverable catalog contain catalog recovery area space. 


Whenever records in a recoverable catalog are defined, deleted, or modified, 
the corresponding information in the catalog recovery area is updated to 
reflect the change. Although no specific commands are required to maintain 
the recovery area, certain volumes must be mounted during defines, alters, 
deletes, and any catalog entry modifications resulting from open, close, or end 
of volume activity. The volumes are: 


ALTER _ The prime catalog recovery volume for the objects being 


altered. ) 


DELETE All volumes that are reference by the entry being deleted and 
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the prime CRA volume. 


DEFINE _ All volumes that are referenced in the DEFINE command. 
Also, the first volume of the base cluster must be mounted 
when alternate indexes and paths are being defined. 


Once a recoverable catalog is defined, it cannot be made nonrecoverable. 
Also, a recoverable catalog cannot be copied. A nonrecoverable catalog can 
be converted and made recoverable through Access Method Services 
commands. This conversion is not necessary unless there is a requirement for 
the recovery capability. 


The Access Method Services commands used to achieve catalog recovery are 
described in OS/VS2 SVS Independent Component: Access Method 
Services. That book also contains specific instructions on how to make an 
existing master catalog recoverable. User catalogs can be converted by using 
the EXPORT, DELETE, DEFINE, and IMPORT commands. 


This publication contains additional information about catalog recovery. In 
the ““Method of Operation” chapter, Diagram EE3 describes the processing 
required to define a catalog recovery area. In the “Program Organization”’ 
chapter, detailed drawings in the ‘“‘Catalog Management I/O Functions” 
section illustrate CRA I/O operations. The ‘‘Data Areas” chapter contains 
the description and the format of all the recovery area records. 


Catalog Recovery Area Record Descriptions 


Catalogs that are defined with the recoverable attribute are associated with 
one or more CRAs (catalog recovery areas). A CRA is a VSAM 
entry-sequenced data set, and every volume owned by a recoverable catalog 
contains one CRA. 


Each CRA contains three types of 512-byte records: 
e Self-describing records 

e Duplicate copies of VSAM catalog entry records 
e CRA free records 


Self-describing records and free records occupy control intervals 0 - 8 in the 
CRA. The control intervals and the specific record they contain are: 


Record 
CI Number Type Description 

0 D Data set record, which describes the CRA data component of 
the CRA cluster 

1 F Free record 

2 C Cluster record, which describes the CRA cluster 

3 L Control record, which manages control interval allocation in 
the CRA 

4 F Free record 

5 E Extension record, which is an extension of the data set record 
in control interval 0 

6,7,8 F Free records 


The formats and contents of the self-describing records are shown later in this 
section. 
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Duplicate copies of catalog records are recorded in the CRA in control 
intervals 9 - n. The volume record for the CRA volume is in control interval 
9. The format and content of these duplicated records are identical to their 
counterparts in the recoverable catalog associated with the CRA. 


Each catalog record that is not self-describing is duplicated in a specific CRA. 
The table that follows shows which CRA contains a given catalog record. In 
the table, initial volume is the first volume on which space was allocated for 


the entity. 
Record 
Catalog Entry Type CRA 
Volume records VW Subject volume 
KSDS cluster records C,E Initial prime index volume 
KSDS data records D,E Initial prime index volume 
KSDS index records LE Initial prime index volume 
AIX cluster record (KSDS) G,E Initial prime index volume of the base cluster 
AIX data record (KSDS) D,E Initial prime index volume of the base cluster 
AIX index record (KSDS) LE Initial prime index volume of the base cluster 
AIX cluster records (ESDS) G,E Initial base data volume 
AIX data records (ESDS) D,E Initial base data volume 
AIX index records (ESDS) LE Initial base data volume 
Path records (KSDS, no AIX) R,E Initial prime index volume 
Path records (ESDS, no AIX) R,E Initial base data volume 
Path records (KSDS, AIX) R,E Initial prime index volume of the base cluster 
Path records (ESDS, AIX) R,E Initial base data volume 
Upgrade records (KSDS) Y,E Initial prime index volume of the base cluster 
Upgrade records (ESDS) Y,E Initial base data volume 
NonVSAM records A,E,U Catalog volume 


True Name Catalog Record Format 


The True Name record associates the volume serial number, data-set name, or 
cluster name specified by the user with the control interval number of the 
catalog record that describes the object (volume, cluster, alternate index, 
path, or data set). True Name records are contained in the high-address part 
of the catalog and are pointed to by the catalog’s index records. The True 
Name record is retrieved using key-sequenced processing. The catalog 
management modules convert the control interval number in the True Name 
record to an RBA for entry-sequenced processing. 


True Name records are 47 bytes long; several might be contained in a 
catalog’s (512-byte) control interval. 


Bytes and 
Offset Bit Pattern Field Name Description 
0 (0) 44 Name of a data set, alternate index, path, or 
cluster, filled on the right with blanks, ora 
volume serial number, filled on the right with 
zeros, specified by the user. 
44(2C) 3 Control interval number of the catalog 


record that describes the object. 
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C 


Catalog Control Record (CCR) Format 


The catalog control record (CCR) is used by catalog management to control 
the allocation of control intervals in the low-address part of the catalog, 
where catalog records, excluding the True Name records and the index, 
reside. The CCR also shows the catalog’s high-used and high-allocated RBA 
values. The catalog control record is the fourth record (control interval) in the 
catalog. 


For a request of one catalog record, catalog management tries to use a record 
that was freed because of deletion. This process is done before using 
unassigned control interval. If more than one catalog record is needed, catalog 
management tries to use contiguous unassigned space in the current extent; if 
sufficient unassigned control interval is not available, records that have been 
deleted are used. 


Catalog Control Record (CCR) Format 


Bytes and 

Offset Bit Pattern Description 

0 (0) 44 Key. 
Byte Meaning 
0 Zeros. 
1-3 Control interval number of this 

record. 

4 Release indicator 
5-43 Zeros. 

44 (2C) | Record type—"‘L.”’ 

45 (2D) 3 Number of the highest control interval within the current 
extent.! 

48 (30) 3 Number of the next free control interval of those that have 
not been previously assigned.! 

51 (33) 3 Count of deleted control intervals, that is, the number of 
control intervals that are free because of deletion.2 

54 (36) 3 First deleted control interval in a chain of control intervals 


that are free because of deletion.2 
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Catalog Control Record Format 


Bytes and 


Offset Bit Pattern 


Description 


J 


The following fields are used to keep track of the RBA values that denote the current 


logical end (high RBA) of parts of the catalog. 


Note: The low key range is the low-address part of the catalog; the high key range is the 


high-address part. 
57 (39) 
61 (3D) 
65 (41) 
69 (45) 
73 (49) 
77 (4D) 
81 (51) 
85 (55) 
89 (59) 
93 (SD) 
97 (61) 
101 (65) 


& f& Sf fF HLH HK F&F HK HL HL FL 


4 


Data, low key range: high-key RBA 

Data, low key range: high-used RBA 

Data, low key range: high-allocated RBA 

Data, high key range: high-key RBA 

Data, high key range: high-used RBA 

Data, high key range: high-allocated RBA 

Index, high level: high-used RBA 

Index, high level: high-allocated RBA 

Index, low key range—sequence set: high-used RBA 
Index, low key range—sequence set: high-allocated RBA 
Index, high key range—sequence set: high-used RBA 
Index, high key range—sequence set: high-allocated RBA 


1 This field is used to keep track of unassigned space within the current extent. 


2 This field is used to keep track of previously-used records that are now available for use as another catalog 


record. 


Free Catalog Record Format 


The Free record indicates that the control interval in which it resides is free 


J 


and points to the next control interval that is free because of deletion. Note 
that the free space in the catalog that has never been assigned is not 
represented by Free records; the Free record is used only to mark a record 


that was used and deleted. 


Bytes and 
Offset Bit Pattern Description 
0 (0) 44 Key. 
Byte 
0 
1-3 
4-43 
44 (2C) 1 Record type—‘‘F.”’ 
45 (2D) 3 
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Meaning 


Zeros. 
Control interval number of this 
record. 
Zeros. 


Control interval number of the next free control interval. 


C 


Data and Index Catalog Record Format 


Data and Index records describe data sets and their indexes. 


Offset 


0 (0) 
1 (1) 
4 (4) 


5 (5) 

11 (B) 
14 (E) 
18 (12) 
22 (16) 
26 (1A) 
44 (2C) 


45 (2D) 
47 (2F) 


48 (30) 


49 (31) 


93 (SD) 


101 (65) 


104 (68) 


107 (6B) 


Bytes and 


Bit Pattern 


| 
3 


Field Name 


ENTIDNO 
RELIND 


CRAVOL 
CRAIDNO 
CRADEVT 
CRACRETS 
CRADITS 


ENTYPE 


ENTNAME 


OWNERID 


DSETCRDT 


DSETEXDT 


ATTRI 


Description 


Zeros. 
Control interval number of this record. 
Release indicator: 


0 = Nonenhanced VSAM; 
1 = Enhanced VSAM. 


CRA volume serial.! 

CRA control interval number. ! 
CRA device type.! 

CRA creation time stamp. 
Data/index identifier timestamp. 
Zeros. 


Record type—‘D”’ for a Data record or “‘I”’ 
for an Index record. 


Record length. 


Number of variable-length fields that precede 
the pointer to an extension record. Always 
zero. 


Length of the fixed-length fields in this 
record, excluding any fixed-length fields 
following displacement 143 (X‘8F’). This 
value is always equal to the displacement 
from the beginning of the record to the 
pointer to an extension record. 


For a Data or Index record, the data set 
name. 


Owner of the data set, specified when the 
data set was defined. 


Data set creation date, in packed-decimal 
form YDD, specified when the data set was 
defined. 


Data set expiration date, in packed-decimal 
form YDD, specified when the data set was 
defined. 


Data set attributes, which are defined using 
Access Method Services commands, as 
follows: 


Speed, which indicates that storage for the 
data set or index is not to be preformatted 
before records are output. 

Unique, which indicates that this data set or 
index must reside in a data space all its own. 
The cluster associated with this component is 
reusable. 

Erase, which indicates that the data set or 
index is to be overwritten with binary zeros 
when deleted. 

This catalog is recoverable. 

Inhibit update, which indicates that the data 
set or index is not to be updated. 
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Data and Index Catalog Record Format 


Bytes and 
Offset Bit Pattern Field Name 


al 


x 
108 (6C) l ATTR2 
00.. .... 
01.. 
LO ss: cess 
Tiles: om: 
OL... 
10 1... 
| 
ee | 
XXX 
109 (6D) l OPENIND 
110 (6E) 4 BUFSIZE 
114 (72) 3 PRIMSPAC 
117 (75) 3 SCONSPAC 
120 (78) I SPACOPTN 
TOs. 55% 
eer 
..XX XXXX 
121 (79) 4 HURBADS 
125 (7D) 4 HARBADS 
129 (81) 4 LRECL 
133 (85) 2 USERINFO 
135 (87) 8 EXCPEXIT 


Description 


Temporary export, which indicates that the 
original copy of this data set or index is not 
to be deleted, even though another copy of it 
exists somewhere else. 

Reserved. 


Data-set sharing attributes as follows: 


The data set can be shared by READ users or 
it can be used by one UPDATE/OUTPUT 
user. 

The data set can be shared by READ users 
and one UPDATE/OUTPUT user. 

The data set can be fully shared. 

The data set can be fully shared; with 
assistance supplied by VSAM. 


Data-set sharing attributes across systems, as 
follows: 


Reserved. 

Reserved. 

The data set can be fully shared. 

The data set can be fully shared; with 
assistance supplied by VSAM. 
Component is not usable. 

Reserved. 


Open indicator flag; if this byte contains 
X‘80’, the data set is open for output. 


Minimum buffer size. 


Primary space allocation for the data set or 
index, specified when the data set or index 
was defined. 


Secondary space allocation for the data set or 
index, specified when the data set or index 
was defined. 


Space options flags. 


Track request, which indicates that space 
allocation was specified in tracks. 

Cylinder request, which indicates that space 
allocation was specified in cylinders. 
Reserved. 


High used RBA of the data set or index. 
High allocated RBA of the data set or index. 


For a Data record, the logical record size of 
the data set described by this Data record. 
For an Index record, always X ‘FF’s. 


User information for the DOS/VS 
indexed-sequential access method 
compatibility interface. 


Exception exit. 


The following 6-byte entry contains control information for the sets of fields that follow 


it. 


143 (8F) 5 


Pointer to horizontal extension record. If this 
record is not continued in an extension 
record, this field contains zeros. 
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J 


J 


Data and Index Catalog Record Format 


Bytes and 
Offset Bit Pattern Field Name Description 
148 (94) 1 The number of set of fields pointers that 
follow.2 

Note: The first set-of-fields pointer contains 

sequence number = 0 and type code = 0. 

When bytes 0 to 2 are nonzero, this 

set-of-fields pointer points to the first 

(vertical) extension record that contains free 

space. The set-of-fields pointer is called the 

ASPT—available-space pointer. When bytes 

0 to 2 are zero, the pointer is a dummy 

set-of-fields pointer—not available to be used 

to point to a set of fields. 
149 (95) VL 5-byte pointers to sets of fields within the 
record. 

Byte Meaning 

0 Reserved. 

1-2 Displacement of the set of fields 
from the beginning of all sets of 
fields in this record. 

3 Bits O and 1 are set to zero. If bit 1 
is on, the set of fields associated 
with this pointer has been deleted; 
the code in bits 2 through 7 of this 
byte and the sequence number in 
byte 4, however, are kept. Bits 2 
through 7 contain a code 
describing the set of fields pointed 
to.2 

4 Sequence number of the set of 
fields pointed to by code.3 For 
example, all sets of fields 
associated with a code of 2 are in 
one sequence. 

VL 5-byte pointers to sets of fields contained in 


vertical Extension records. 


Byte Meaning 


0-2 Control interval number of the 
extension record that contains this 
set of fields. 


3 Bits 0 and 1 are set to B‘10’. Bits 2 
through 7 contain a code that 
describes the set of fields pointed 
to.3 


4 Sequence number of the set of 
fields pointed to by code.3 For 
example, all sets of fields 
associated with a code of 2 are in 
one sequence. 


: Zeros if the catalog is not recoverable or if there is no assocated CRA volume. 


2 Fields describing (a) the AMDSB, (b) the control interval number of a Cluster record associated 
with this record, (c) the volumes on which a data set resides, and (d) the password information 
associated with a data set are grouped into sets of fields. Pointers to each set of fields identify 
the type of information contained in each set of fields. 


3 If the pointer is associated with AMDSB information, the code is 1; with cluster information, 
the code is 2; with volume information, the code is 3; or with password information, fhe code 
is 4. 


Data Areas 489 


AMDSB (Access Method Data Set Statistics Block) 
Set of Fields Format 


The AMDSB set of fields contains a copy of the AMDSB control block, and 
is updated each time the data set is closed. This set of fields is associated with 
a pointer that contains a type (group) code of 1. 


Bytes and 
Offset Bit Pattern Field Name Description 
0 (0) 2 Control information. 


Byte Meaning 


0 Count of the number of 
variable-length fields in this set of 
fields. 

1 Hexadecimal displacement to the 


first variable-length field from the 
beginning of this set of fields. 


2 (2) 96 AMDSBCAT AMDSB—Access Method Data Statistics 
Block. See ‘““Data Areas” for detailed 
information about the AMDSB. 


Association (Cluster) Set of Fields Format 


The control interval number of the cluster catalog record associated with the 
data or index catalog record is contained in the association set of fields. This 
set of fields is associated with a pointer that contains a type (group) code of 


2. 
Bytes and 
Offset Bit Pattern Field Name Description 
0 (0) 2 Control information. 


Byte Meaning 


0 Count of the number of 
variable-length fields in this set of 
fields. 

1 Hexadecimal displacement to the 


first variable-length field from the 
beginning of this set of fields. 
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J 


Association (Cluster) Set of Fields Format 


Bytes and 
Offset Bit Pattern Field Name Description 


2 (2) | TYPE ““C,” which indicates that this record is 
associated with a Cluster record, or ““G’’, 
which indicates this is the data component or 
the index component of an alternate index. 
The data component of a cluster may have 
an additional ‘““Y”’ association if the cluster 
has an alternate index that is part of the 
upgrade set. 


3 (3) 3 NAME Control interval number of the Cluster or 
Alternate Index record associated with this 
record. 


Volume Information Set of Fields Format 


All extents allocated to the data set, index, or data set’s key range on a 
volume are described by a volume information set of fields. This set of fields 
is associated with a pointer that contains a type (group) code of 3. 


Byte and 
Offset Bit Pattern Field Name Description 
0 (0) 2 Control information. 

Byte Meaning 

0 Count of the number of 
variable-length fields in this set of 
fields. 

1 Hexadecimal displacement to the 
first variable-length field from the 
beginning of this set of fields. 

2 (2) 4 DEVTYP Device type. 
6 (6) 6 VOLSER Volume serial number. 
12 (C) 2 FILESEQ File sequence number. (This field is provided 


for compatibility with the OS/VS catalog.) 
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Data and Index Catalog Record: Volume Information Set of Fields Format 


Offset 
14 (E) 


15 (F) 


16 (10) 


20 (14) 
24 (18) 
28 (1C) 
32 (20) 
34 (22) 
36 (24) 


37 (25) 


39 (27) 


Bytes and 


Bit Pattern 


ooeX 


oeXX 


1 


XXXX 


Nn N Sf Hh FA 


— 


VL 


VL 


VL 


Field Name 
VOLFLG 


NOEXTNT 


HKRBA 


HURBA 
HARBA 
PHYBLKSZ 
NOBLKTRK 
NOTRKAU 
ITYPEXT 


DSDIRSN 


LOKEYV 


HIKEYV 


EXTENT 


Description 
Volume flags, as follows: J 
Prime, which indicates that this volume was 
allocated when the data set was defined or 

that a data set that is not divided into parts 
according to key has been extended to this 
volume. 

Candidate, which indicates that this volume 

is available for use by the data set described 

by this record. 

Overflow, which indicates that this volume is 
being used by a data set that is divided into 

parts according to key, but this volume was 

not allocated when the data set was defined. 
Reserved 


Number of extents allocated in this set of 
extents on this volume for this data set. 


RBA of the data control interval with the 
high key. 


High-used RBA. 

High-allocated RBA. 

Blocksize. 

Number of blocks per track. 

Number of tracks per allocation unit. 
Flags: 


In an index record: the sequence set is with 
the data. 

The extents are not preformatted 
Reserved 


JY 


Data set directory sequence number in the 
volume record. 


Low key on the volume. This field can be a 
maximum of 64 bytes long; the first two bytes 
indicate the length of the field. 


High key on the volume. This field can be a 
maximum of 64 bytes long; the first two bytes 
indicate the length of the field. 


This field contains a 2-byte length field, 
followed by a 20-byte field for each extent. 
The 20-byte field describes the start and end 
of the extent, in the form 
SSCCHHCCHHTTDDDDDDDD, where SS 
is the data space extent’s sequence number, 
CCHHCCHH is the low and high cylinder 
and head, TT is the number of tracks, and 
DDDDDDDD is the low and high RBA of 
the extent. 
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Password Set of Fields Format 


Password information, if any, is contained in the password set of fields. This 
set of fields is associated with a pointer that contains a type (group) code 


of 4. 


Offset 
0 (0) 


2 (2) 


34 (22) 


42 (24) 


44 (2C) 


52 (34) 


Cluster Catalog Record Format 


Bytes and 
Bk Pattern 


2 


32 


VL 


Field Name 


PASSWORD 


PASSPRMT 


PASSATMP 


USVRMDUL 


USERAREC 


Description 

Control information 

Byte Meaning 

0 Count of the number of 
variable-length fields in this set of 
fields. 

1 Hexadecimal displacement to the 


first variable-length field from the 
beginning of this set of fields. 


Four eight-character passwords, in the 
following order: Master, Control Interval, 
Update, and Read. 


Password prompting code name that allows 
the operator to provide the correct password 
without displaying the data set name. 


Maximum number of attempts allowed for 
the operator or TSO operator to provide 
correct password. 


Name of user’s security-verification module, 
if any. 


User-authorization record. This field can be a 
maximum of 256 bytes long. 


The Cluster record describes a data set and its index, if any, and may point to 
one or more alternate indexes. 


Offset 


0 (0) 
1 (1) 
4 (4) 


5 (5) 

11 (B) 
14 (E) 
18 (12) 
22 (16) 
26 (1A) 
44 (2C) 
45 (2D) 
47 (2F) 


Bytes and 
Bit Pattern 
1 
3 
1 


h_, Fb fF W AH 


Field Name 


ENTIDNO 
RELIND 


CRAVOL 
CRAIDNO 
CRADEVT 
CRACRETS 
CRADITS 


ENTYPE 


Description 


Zeros. 
Control interval number of this record. 
Release indicator: 


0 = Nonenhanced VSAM; 
1 = Enhanced VSAM. 


CRA volume serial.! 

CRA control interval number.! 
CRA device type. ! 

CRA creation time stamp. 
Data/index identifier timestamp. 
Zeros. 

Record type—“C..”’ 

Record length. 


Number of variable-length fields that precede 
the pointer to an extension record. Always 
zero. 
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Cluster Catalog Record Format 


Bytes and 
Offset Bit Pattern Field Name 
48 (30) 1 
49 (31) 44 ENTNAME 
93 (5D) 8 OWNERID 
101 (65) 3 DSETCRDT 
104 (68) 3 DSETEXDT 


Description 


Length of the fixed-length fields in this 
record, excluding any fixed-length fields that 
follow displacement 106 (6A). This value is 
always equal to the displacement from the 
beginning of the record to the pointer to an 
extension record. 


Name of the cluster described by this record. 


Owner of the data set, specified when the 
data set was defined. 


Data set creation date, in packed-decimal 
form YDD, specified when the data set was 
defined. 


Data set expiration date, in packed-decimal 
form YDD, specified when the data set was 
defined. 


The following six-byte entry contains control information for the sets of fields that 


follow it. 

107 (6B) 5 
112 (70) | 
113 (71) VL 


Pointer to horizontal extension record. If this 
record is not continued on an extension 
record, this field contains zeros. 


The number of set-of-field pointers that 
follow.2 


Note: The first set-of-fields pointer may be 
special (meaning that the field-name 
dictionary permits catalog management to 
locate information that is not contained in 
catalog records); if this is the case, its 
sequence number = 0 and type code = 0. 
When bytes 0 to 2 are nonzero, this 
set-of-fields pointer points to the first 
(vertical) extension record that contains free 
space. The set-of-fields pointer is called the 
ASPT—available-space pointer. When bytes 
0 to 2 are zero, the pointer is a dummy 
set-of-fields pointer—not available to be used 
to point to a set of fields. 


5-byte pointers to sets of fields within the 
record. 


Byte Meaning 
0 Reserved. 
1-2 Displacement of the set of fields from 


the beginning of all sets of fields in 
this record. 


3 Bits 0 and 1 are set to zero. If bit 1 is 
on, the set of fields associated with 
this pointer has been deleted; the 
code in bits 2 through 7 of this byte 
and the sequence number in byte 4, 
however, are kept. Bits 2 through 7 
contain a code describing the set of 
fields pointed to.3 


4 Sequence number of the set of fields 
pointed to by code.3 For example, all 
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4 


Cluster Catalog Record Format 


Bytes and 
Offset Bit Pattem Field Name Description 
sets of fields associated with a code 
of 2 are in one sequence. 
VL 5-byte pointers to sets of fields contained in 


vertical Extension records. 


Byte Meaning 

0-2 Control interval number of the 
extension record that contains this set 
of fields. 

3 Bits 0 and 1 are set to B‘10’. Bits 2 


through 7 contain a code that 
describes the set of fields pointed to.3 


4 Sequence number of the set of fields 
pointed to by code.3 For example, all 
sets of fields associated with a code 
of 2 are in one sequence. 


1 Zeros if the catalog is not recoverable or if there is no associated CRA entry. 


2 Fields describing (a) the control interval number of a Data or Index record 
associated with this cluster or (b) the password information associated with a 
data set are grouped into sets of fields. Pointers to each set of fields identify the 
type of information contained in each set of fields. 


3 If the pointer is associated with cluster information (the control interval number 
of a Data or Index record), the code is 2; with password information, the code 
is 4. 


Association (Data and Index) Set of Fields Format 


The control interval number of the Data and Index Catalog Record associated 
with the cluster is contained in an association set of fields. This set of fields is 
associated with a pointer that contains a type (group) code of 2. 


Bytes and 
Offset Bit Pattern Field Name Description 
0 (0) 2 Control information. 


Byte Meaning 


0 Count of the number of 
variable-length fields in this set of 
fields. 

1 Hexadecimal displacement to the 


first variable-length field from the 
beginning of this set of fields. 


2 (2) 1 TYPE If this entry describes an Index Record, “I’’; 
if this entry describes a Data record, “‘D;’’ if 
this entry describes an alternate index entry, 
“GG.” 


3 (3) 3 NAME Control interval number of a Data, Index, or 
Alternate Index record that is part of the 
cluster described by this record. 
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Password Set of Fields Format 


Password information, if any, is contained in the password set of fields. This 
set of fields is associated with a pointer that contains a type (group) code 


of 4. 


Offset 
0 (0) 


2 (2) 


34 (22) 


42 (2A) 


44 (2C) 


52 (34) 


Alternate Index Catalog Record Format 


Bytes and 
Bit Pattern 


Zz 


32 


VL 


Field Name 


PASSWORD 


PASSPRMT 


PASSATMP 


USVRMDUL 


USERAREC 


Description 


Control information. 


Byte Meaning 

0 Count of the number of 
variable-length fields in this set of 
fields. 

| Hexadecimal displacement to the 


first variable-length field from the 
beginning of this set of fields. 


Four eight-character passwords, in the 
following order: Master, Control Interval, 
Update, and Read. 


Password prompting code name that allows 
the operator to provide the correct password 
without displaying the data set name. 


Maximum number of attempts allowed for 
the operator or TSO operator to provide 
correct password. 


Name of the user’s security-verification 
module, if any. 


User-authorization record. This field can be a 
maximum of 256 bytes long. 


The alternate index record describes the data and index components 
associated with the alternate index. In addition, it points to the related cluster 
entry and it can point to one or more path entries. The alternate index 
grouping is similar to the grouping of a key-sequenced data set except for 
different record types (‘‘G” rather than “‘C’’). 


Offset 
0 (0) 
1 (1) 
4 (4) 


5 (5) 

11 (B) 
14 (E) 
18 (12) 
22 (16) 
44 (2C) 
45 (2D) 
47 (2F) 


Bytes and 
Bit Pattern 


1 


&- fk WwW DH 


Field Name 


ENTIDNO 
RELIND 


CRAVOL 
CRAIDNO 
CRADEVT 
CRACRETS 


ENTYPE 


Description 
Zeros. 
Control interval number of this record. 


Release indicator: 
0=Nonenhanced VSAM; 
1=Enhanced VSAM. 


CRA volume serial. 

CRA control interval number. 
CRA device type. 

CRA creation time stamp. 
Zeros. 

Record type—‘‘G.”’ 
Record length. 


Number of variable-length fields that precede 
the pointer to an extension record (always 0). 
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Alternate Index Catalog Record Format 


Bytes and 

Offset Bit Pattern Field Name Description 

48 (30) 1 Length of nonrepeating fixed-length fields 
(always X‘6C’). 

49 (31) 44 ENTNAME Name of the alternate index described by this 
record. 

93 (5D) 8 OWNERID Owner of the alternate index described by 
this record; specified when the alternate 
index was defined. 

101 (65) 3 DSETCRDT Alternate index creation date, in the packed 
decimal form YDD. 

104 (68) 3 DSETEXDT Alternate index expiration date, in the 
packed decimal form YDD. 

107 (6B) 1 RGATTR Alternate index attributes: 

Meus, cote: If there is an association in the upgrade 
entry, indicates that this alternate index is a 
member of the upgrade set. 

.XXX XXXX Reserved. 


The following 6-byte entry contains control information for the sets of fields that 
follow it. 


108 (6C) 5 ; Pointer to the horizontal extension record. If 
this record is not continued on an extension 
record, this field contains zeros. 


113 (71) 1 The number of set of fields pointers that 
follow.! 


Note: The first set-of-fields pointer may be 
special (meaning that the field-name 
dictionary permits catalog management to 
locate information that is not contained in 
catalog records); if this is the case, its 
sequence number = 0 and type code = 0. 
When bytes 0 to 2 are nonzero, this 
set-of-fields pointer points to the first 
(vertical) extension record that 


contains free space. The set-of-fields pointer is called the ASPT—available-space pointer. 
When bytes 0 to 2 are zero, the pointer is a dummy set-of-fields pointer—not available to 
be used to point to a set of fields. 


114 (72) VL 5-byte pointers to sets of fields within the 
record. 


Byte Meaning 
0 Reserved. 


1-2 Displacement of the set of fields from 
the beginning of all sets of fields in 
this record. 


3 Bits 0 and 1 are set to zero. If bit 1 is 
on, the set of fields associated with 
this pointer has been deleted; the 
type (group) code in bits 2 through 7 
of this byte and the sequence number 
in byte 4, however, are kept. Bits 2 
through 7 contain a type (group) 
code describing the set of fields 
pointed to. 
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Alternate Index Catalog Record Format 


Bytes and 
Offset Bit Pattern Field Name Description 
4 Sequence number of set of fields 
pointed to by code. For example, all 
sets of fields associated with a code 
of 2 are in one sequence. 
VL 5-byte pointers to sets of fields contained in 


vertical extension records. 


Byte Meaning 

0-2 Control interval number of the 
extension record that contains this set 
of fields. 

3 Bits 0 and 1 are set to B‘10’. Bits 2 


through 7 contain a type (group) 
code that describes set of fields 
pointed to. 


4 Sequence number of the set of fields 
pointed to, by type (group) code. For 
example, all sets of fields associated 
with a code of 2 are in one sequence. 


1 Fields describing (a) the control interval number of a Data or Index catalog 
record associated with this cluster, or (b) the password information associated 
with a data set are grouped into sets of fields. Pointers to each set of fields 
identify the type of information contained in each set of fields. 


Association Set of Fields Format 


The associations in this entry are partially ordered; however, no assumptions 
should be made as to the relative placement or physical position of these 
associations in the alternate index record. 


Bytes and 
Offset Bit Pattern Field Name Description 
0 (0) 2 Control information. 
2 (2) 1 TYPE Record type pointed to by the following 
control interval number. 
3 (3) 3 NAME Control interval number. 


The association ordering by record type is: 


Record Type Description 


D Alternate index data (D) component association with occurrence 
sequence number = 1. 

I Alternate index index (I) component association with occurrence 
sequence number = 2. 

G Base cluster (C) component association with occurrence sequence 
number = 3. 

R Maximum of 252 path (R) associations. 
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Password Set of Fields Format 


Password information, if any, is contained in the password set of fields. This 
set of fields is associated with a pointer that contains a type (group) code 


of 4. 


Offset 


0 (0) 


2 (2) 
34 (22) 


42 (2A) 
44 (2C) 


52 (34) 


Path Catalog Record Format 


Bytes and 
Bit Pattern 


2 


32 


VL 


Field Name 


PASSWORD 


PASSPRMT 


PASSATMP 


USVRMDUL 


USERAREC 


Description 


Control information. 


Byte Meaning 

0 Count of the number of 
variable-length fields in this set 
of fields. 

| Hexadecimal displacement to 


the first variable-length field 
from the beginning of this set of 
fields. 


Four eight-character passwords, in the 
following order: MASTER, CONTROL 
INTERVAL, UPDATE, and READ-ONLY. 


Password prompting code name that allows 
the operator to provide the correct password 
without displaying the data set’s DSNAME. 


Maximum number of attempts allowed for 
the operator to provide the correct password. 


Name of user's security-verification module, 
if any. 


User-authorization record. This field can be a 
maximum of 256 bytes long. 


The path record describes an alternate index and its associated base data set 
to give an alternate, logical view of the base data set. It also may be used as 
an alias for a base data set to inhibit upgrade set unit allocation. 


Offset 
0 (0) 
1 (1) 
4 (4) 


5 (5) 

11 (B) 
14 (E) 
18 (12) 
22 (16) 
44 (2C) 


45 (2D) 


47 (2F) 


48 (30) 


Bytes and 
Bit Patterns 


1 


Field Name 


ENTIDNO 
RELIND 


CRAVOL 
CRAIDNO 
CRADEVT 
CRACRETS 


ENTYPE 


Description 
Zeros. 
Control interval number of this record. 


Release indicator: 
0=Nonenhanced VSAM; 
1=Enhanced VSAM. 


CRA (catalog recovery area) volume serial. 
CRA control interval number. 

CRA device type. 

CRA creation time stamp. 

Zeros. 

Record type—‘‘R.”’ 

Record length. 


Number of variable-length fields that precede 
the address of an extension record (always 
zero). 


Length of nonrepeating fixed-length fields 
(always X‘6C’). 
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Path Catalog Record Format 


Bytes and 
Offset Bit Pattern 
49 (31) 44 
93 (5D) 8 
101 (65) 3 
104 (68) 3 
107 (6B) | 

| Pe 

XXX XXXX 


Field Name 


ENTNAME 
OWNERID 


DSETCRDT 


DSETEXDT 


RGATTR 


Description 


Name of the path described by this record. 


Owner of the path; specified when the path 
was defined. 


Path creation date; in the packed-decimal 
form YDD. 


Path expiration date; in the packed-decimal 
form YDD. 


Path attributes: 


Include upgrade set during unit allocation 
and when opening this path. 


Reserved. 


The following 6-byte entry contains control information for the sets of fields that follow 


it. 


108 (6C) 5 

113 (71) | 

114 (72) VL 
VL 


Pointer to the horizontal extension record. If 
this record is not continued on an extension 
record, this field contains zeros. 


The number of set of fields pointers that 
follow.! 


Note: The first set-of-fields pointer contains 
sequence number = 0 and type code = 0. 
When bytes 0 to 2 are nonzero, this 
set-of-fields pointer points to the first 
(vertical) extension record that contains free 
space. The set-of-fields pointer is called the 
ASPT—available-space pointer. When bytes 
0 to 2 are zero, the pointer is a dummy 
set-of-fields pointer—not available to be used 
to point to a set of fields. 


5-byte pointers to sets of fields within the 
record. 


Byte Meaning 
0 Reserved. 
1-2 Displacement of the set of fields 


from the beginning of all sets of 
fields in this record. 


3 Bits 0 and | are set to zero. If bit 
1 is on, the set of fields 
associated with this pointer has 
been deleted; the type (group) 
code in bits 2 through 7 of this 
byte and the sequence number 
in byte 4, however, are kept. 
Bits 2 through 7 contain a type 
(group) code describing the set 
of fields pointed to. 


4 Sequence number of the set of 
fields pointed to by code. For 
example, all sets of fields 
associated with a code of 2 are 
in One sequence. 


5-byte pointers to sets of fields contained in 
vertical extension records. 
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Path Catalog Record Format 
Bytes and 
Offset Bit Pattern Field Name Description 
Byte Meaning 
0-2 Control interval number of the 


extension record that contains 
this set of fields. 


3 Bits 0 and 1 are set to B‘10.’ Bits 
2 through 7 contain a type 
(group) code that describes set 
of fields pointed to. 


4 Sequence number of the set of 
fields pointed to, by type 
(group) code. For example, all 
sets of fields associated with a 
code of 2 are in sequence. 
1 Fields describing (a) the control interval number of a Data or Index catalog 
record associated with this cluster, or (b) the password information associated 


with a data set are grouped into sets of fields. Pointers to each set of fields 
identify the type of information contained in each set of fields. 


Association Set of Fields Format 


The associations in this entry are ordered in the sense that each association 
occurrence has a defined group occurrence sequence number; however, no 
assumptions should be made as to the relative placement or physical position 
of these associations in the path record. 


Bytes and 
Offset Bit Pattem Field Name Description 
0 (0) 2 Control information. 
2 (2) 1 TYPE Record type which is pointed to by the 
following control interval number. 
3 (3) 3 NAME Control interval number. 


If this record describes a path over an alternate index, the association 
ordering by record type is: 


Record Type Description 


G Alternate index (G) entry association with occurrence sequence 
number = 1. 

D Alternate index data (D) component association with occurrence 
sequence number =2. 

J Alternate index index (I) component association with occurrence 
sequence number = 3. 

D Base data (D) component association with occurrence sequence 
number = 4. 

I Base index (I) component association with occurrence sequence 


number = 5. This association exists only if the base cluster is a 
key-sequenced data set. 
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If this record describes a path over a base cluster, the association ordering by 
record type is: 


Record Type Description 


C 


D 


Password Set of Fields Format 


Base cluster (C) component association with occurrence sequence 
number = 1. 


Base data (D) component association with occurrence sequence 
number = 2. 


Base index (I) component association with occurrence sequence 
number = 3. This association exists only if the base cluster is a 
key-sequenced data set. 


Password information, if any, is contained in the password set of fields. This 
set of fields is associated with a pointer that contains a type (group) code of 


2 (2) 


34 (22) 


42 (2A) 


44 (2C) 


52 (34) 


Bytes and 
Bit Pattern Field Name Description 


2 Control information. 


Byte Meaning 


0 Count of the number of 
variable-length fields in this set 
of fields. 


1 Hexadecimal displacement to 
the first variable-length field 
from the beginning of this set of 
fields. 


32 PASSWORD Four eight-character passwords, in the 
following order: MASTER, CONTROL 
INTERVAL, UPDATE, and READ-ONLY. 


8 PASSPRMT Password prompting code name that allows 
the operator to provide the correct password 
without displaying the data set’s DSNAME. 


2 PASSATMP Maximum number of attempts allowed for 
the operator to provide the correct password. 


8 USVRMDUL Name of user’s security-verification module, 
if any. 


VL USERAREC User-authorization record. This field can be a 
maximum of 256 bytes long. 
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Upgrade Catalog Record Format 
The upgrade record describes all the alternate indexes that make up the 
upgrade set. It is pointed to by an association in the base data component. 


Bytes and 
Offset Bit Pattern Field Name Description 


0 (0) 1 Zeros. 
1 (1) 3 ENTIDNO Control interval number of this record. 


4 (4) | RELIND Release indicator: 
0=Nonenhanced VSAM; 
1=Enhanced VSAM 


CRAVOL CRA volume serial number. 
CRAIDNO CRA control interval number. 
14 (E) CRADEVT CRA device type. 

18 (12) CRACRETS CRA creation timestamp. 

22 (16) 22 Zeros. 


5 (5) 
11 (B) 


b&b f WwW NH 


44 (2C) | ENTYPE Record type—‘‘Y.”’ 
45 (2D) 2 Record length. 


47 (2F) | Number of variable-length records that 
precede the pointer to an extension record 
(always 0). 


The following 6-byte entry contains control information for the sets of fields that 
follow it. 


49 (31) 5 Pointer to the horizontal extension record. If 
this record is not continued on an extension 
record, this field contains zeros. 


The number of set of fields pointers that 
follow.! 


Note: The first set-of-fields pointer contains 
sequence number = 0 and type code = 0. 
When bytes 0 to 2 are nonzero, this 
set-of-fields pointer points to the first 
(vertical) extension record that contains free 
space. The set-of-fields pointer is called the 
ASPT—available-space pointer. When bytes 
0 to 2 are zero, the pointer is a dummy 
set-of-fields pointer—not available to be used 
to point to a set of fields. 


55 (37) VL 5-byte pointers to sets of fields within the 
record. 


Byte Meaning 
0 Reserved. 


1-2 Displacement of the set of fields 
from the beginning of all sets of 
fields in this record. 


3 Bits 0 and 1 are set to zero. If bit 
1 is on, the set of fields 
associated with this pointer has 
been deleted; the type (group) 
code in bits 2 through 7 of this 
byte 4, however, are kept. Bits 2 
through 7 contain a type (group) 
code describing the set of fields 
pointed to. 
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Upgrade Catalog Record Format 


Offset 


Bytes and 
Bit Pattern 


VL 


Field Name 


Description 


4 Sequence number of the set of 
fields pointed to by code. For 
example, all sets of fields 
associated with a code of 2 are 
in One sequence. 


5-byte pointers to sets of fields contained in 
vertical extension records. 


Byte Meaning 


0-2 Control interval number of the 
extension record that contains 
this set of fields. 


3 Bits 0 and 1 are set to B‘10.’ Bits 
2 through 7 contain a type 
(group) code that describes set 
of fields pointed to. 


4 Sequence number of the set of 
fields pointed to, by type 
(group) code. For example, all 
sets of fields associated with a 
code of 2 are in one sequence. 


! Fields describing (a) the control interval number of a Data or Index catalog 
record associated with this cluster, or (b) the password information associated 
with a data set are grouped into sets of fields. Pointers to each set of fields 
identify the type of information contained in each set of fields. 


Association Set of Fields Format 


The associations in this entry are actually twin associations consisting of a 


data association and index association. 


Offset 


0 (0) 
2 (2) 


3 (3) 


6 (6) 


7 (7) 


Bytes and 
Bit Pattern 


3 


Field Name 


TYPE 


NAME2 


Description 


Control information. 


‘““D”’, which indicates the following control 
interval number is for the data component of 
an alternate index in the upgrade set. 


Control interval number of the alternate 
index data component. 


“T’’, which indicates the following control 
interval number is for the index component 
of an alternate index in the upgrade set. 


Control interval number of the alternate 
index index component. 


These twin associations exist only in upgrade records (type ““Y’’), and the set 
of twin associations in any given upgrade record entry is always unique. 
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NonVSAM Catalog Record Format 


The NonVSAM record describes a data set organized differently from VSAM 


data set organization. 


Bytes and 
Offset Bit Pattern 
0 (0) 1 
1 (1) 3 
4 (4) 1 
5 (5) 6 
11 (B) 3 
14 (E) 4 
18 (12) 4 
22 (16) 4 
26 (1A) 18 
44 (2C) 1 
45 (2D) 2 
47 (2F) 1 
48 (30) 1 
49 (31) 44 
93 (SD) 8 
101 (65) 3 
104 (68) 3 


Field Name 


ENTIDNO 
RELIND 


CRAVOL 
CRAIDNO 
CRADEVT 
CRACRETS 
CRADITS 


ENTYPE 


ENTNAME 


OWNERID 


DSETCRDT 


DSETEXDT 


Description 


Zeros. 
Control interval number of this record. 


Release indicator: 
0=Nonenhanced VSAM; 
1=Enhanced VSAM. 


CRA volume serial.! 

CRA control interval number. ! 
CRA device type.! 

CRA creation time stamp. 
Data/index identifier time stamp. 


Zeros. 


+9 


Record type— ‘A. 
Record length. 


Number of variable-length fields that precede 
the pointer to an extension record. Always 
zero. 


Length of the fixed-length fields in this 
record, excluding any fixed-length fields 
following displacement 92 (SC). This value is 
always equal to the displacement from the 
beginning of the record to the pointer to an 
extension record. 


Name of the data set described by this 
record. 


Owner of the data set; specified when the 
data set was defined. 


Date data set was created; in packed-decimal 
form YDD. 


Date data set expires; in packed-decimal 
form YDD. 


The following 6-byte entry contains control information for the set of fields that follow 


it. 
107 (6B) 


112 (70) 


5 


1 


Pointer to horizontal extension record. If this 
record is not continued on an extension 
record, this field contains zeros. The 
NonVSAM catalog record is usually not 
extended. 


The number of set-of-fields pointers that 
follow.2 


Note: The first set-of-fields pointer contains 
sequence number = 0 and type code = 0. 
When bytes 0 to 2 are nonzero, this 
set-of-fields pointer points to the first 
(vertical) extension record that contains free 
space. The set-of-fields pointer is called the 
ASPT—available-space pointer. When bytes 
0 to 2 are zero, the pointer is a dummy 
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NonVSAM Catalog Record Format 


Bytes and 
Offset Bit Pattern Field Name Description 

set-of-fields pointer—not available to be used 

to point to a set of fields. 

113 (71) VL 5-byte pointers to sets of fields within the 
record. 

Byte Meaning 

0 Reserved. 

1-2 Displacement of the set of fields 
from the beginning of all sets of 
fields in this record. 

3 Bits O and 1 are set to zero. If bit 
1 is set on, the set of fields 
associated with this pointer has 
been deleted; the code in bits 2 
through 7 and the sequence 
number in byte 4, however, are 
kept. Bits 2 through 7 contain a 
value of 3, which indicates that 
the set of fields pointed to 
contains information about a 
volume on which this data set 
resides. 

4 Sequence number of the set of 
fields pointed to. 

VL 5-byte pointers to sets of fields contained in 


vertical Extension records. 
Byte Meaning 


0-2 Control interval number of the 
extension record that contains 
this set of fields. 


3 Bits O and 1 are set to B‘10’. Bits 
2 through 7 contain a value of 3, 
which indicates that the set of 
fields pointed to contains 
information about a volume on 
which this data set resides. 


4 Sequence number of the set of 
fields pointed to. 
1 Zeros if the catalog is not recoverable or if there is no associated CRA volume. 


2 Fields describing the volumes on which a data set resides are grouped into sets of 
fields. Pointers to each set of fields identify the type of information contained in 
the set of fields. 
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J 


Volume Information Set of Fields Format 


Each volume that contains space allocated to the nonVSAM data set is 
described by a volume information set of fields. This set of fields is associated 
with a pointer that contains a type (group) code of 3. 


Offset 
0 (0) 


2 (2) 
6 (6) 
12 (C) 


14(D) 


Bytes and 
Bit Pattern 


2 


ooeX XXXX 


User-Catalog Catalog Record Format 


The User-Catalog record describes a user catalog. 


Offset 
0 (0) 
1 (1) 
4 (4) 


5 (5) 

11 (B) 
14 (E) 
18 (12) 
22 (16) 
26 (1A) 
44 (2C) 
45 (2D) 
47 (2F) 


Bytes and 
Bit Pattern 


1 


Field Name 


DEVTYP 
VOLSER 
FILESEQ 


VOLFLG 


Field Name 


ENTIDNO 
RELIND 


CRAVOL 
CRAIDNO 
CRADEVT 
CRACRETS 
CRADITS 


ENTYPE 


Description 


Control information. 


Byte Meaning 

0 Count of the number of 
variable-length fields in this set of 
fields. 

| Hexadecimal displacement to the 


first variable-length field from the 
beginning of this set of fields. 


Device type. 
Volume serial number. 


File sequence number. (This field is provided 
for compatibility with the OS/VS catalog, 
and is used for nonVSAM data sets that 
reside on tape volumes. ) 


Volume flags, as follows: 


Prime, which indicates that this volume was 
allocated when the by the data set described 
by this record. 

Overflow, which indicates that this volume is 
being used by the data set, but this volume 
was not allocated when the data set was 
defined. 

Reserved. 


Description 
Zeros. 
Control interval number of this record. 


Release indicator: 
O=Nonenhanced VSAM; 
1=Enhanced VSAM. 


CRA volume serial.! 

CRA control interval number. ! 
CRA device type. ! 

CRA creation time stamp. 
Data/index identifier timestamp. 
Zeros. 

Record type—‘‘U.”’ 
Record length. 


Number of variable-length fields that precede 
the pointer to an extension record. Always 
zero. 
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User-Catalog Catalog Record Format 


Bytes and bd 

Offset Bit Patten Field Name Description 

48 (30) 1 Length of the fixed-length fields in this 
record, excluding any fixed-length fields 
following displacement 92 (5C). This value is 
always equal to the displacement from the 
beginning of the record to the pointer to an 
extension record. 

49 (31) 44 ENTNAME Name of the user catalog described by this 


record. 


The following 6-byte entry contains control information for the sets of fields that follow 
it. 


93 (5D) 5 Pointer to horizontal extension record. If this 
record is not continued on an extension 
record, this field contains zeros. The 
user-catalog catalog record is usually not 
extended. 


98 (62) | The number of set-of-fields pointers that 
follow.2 


Note: The first set-of-fields pointer contains 
sequence number = 0 and type code = 0. 
When bytes 0 to 2 are nonzero, this 
set-of-fields pointer points to the first 
(vertical) extension record that contains free 
space. The set-of-fields pointer is called the 
ASPT—available-space pointer. When bytes 
0 to 2 are zero, the pointer is a dummy 
set-of-fields pointer—not available to be used 
to point to a set of fields. 


VL 5-byte pointers to sets of fields within the 
record. 


Byte Meaning 
0 Reserved 


1-2 Displacement of the set of fields from 
the beginning of all sets of fields in 
this record. 


3 Bits 0 and 1 are set to zero. If bit 1 is 
on, the set of fields associated with 
this pointer has been deleted; the 
code in bits 2 through 7 of this byte 
and the sequence number in byte 4, 
however, are kept. Bits 2 through 7 
contain a value of 3, which indicates 
that the set of fields pointed to 
contains volume information. 


4 Sequence number of the set of fields 
pointed to. 
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J 


User-Catalog Catalog Record Format 


Bytes and 
Offset Bit Pattern Field Name Description 
VL 5-byte pointers to sets of fields contained in 

vertical Extension records. 

Byte Meaning 

0-2 Control interval number of the 
extension record that contains this set 
of fields. 

3 Bits 0 and 1 are set to B‘10’. Bits 2 


through 7 contain a value of 3, which 
indicates that the set of fields pointed 
to contains volume information. 


4 Sequence number of the set of fields 
pointed to. 
! Zeros if the catalog is not recoverable or if there is no associated CRA volume. 


2 Fields describing the volumes on which the user catalog resides are grouped into 
sets of fields. Pointers to each set of fields identify the type of information 
contained in the set of fields. 


Volume Information Set of Fields Format 


Each volume that contains space allocated to the user catalog (and, therefore, 
is owned by the user catalog is described by a volume information set of 
fields. This set of fields is associated with a pointer that contains a type 
(group) code of 3. 


Bytes and 
Offset Bit Pattern Field Name Description 


0 (0) 2 Control information. 


Byte Meaning 


0 Count of the number of 
variable-length fields in this set of 
fields. 

| Hexadecimal displacement to the 
first variable-length field from the 
beginning of this set of fields. 


2 (2) 4 DEVTYP Device type. 
6 (6) 6 VOLSER Volume serial number. 


12 (C) 2 FILESEQ File sequence number. (This field is provided 
for compatibility with the OS/VS catalog.) 


14 (E) | VOLFLG Volume flags, as follows: 


| Farerrer Prime, which indicates that this volume was 
allocated when the catalog was defined. 

 esccies Candidate, which indicates that this volume 
is available for use by the catalog. 

ves Weck Overflow, which indicates that this volume is 
being used by the catalog. but this volume 
was not allocated when the catalog was 
defined. 

weeX XXXX Reserved. 
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Volume Catalog Record Format 


The Volume record describes VSAM data spaces, their extents, and the data 
sets that reside in VSAM data spaces. 


Bytes and 


Offset 


0 (0) 
1 (1) 
4 (4) 


5 (5) 

11 (B) 
14 (E) 
18 (12) 
22 (16) 


44 (2C) 
45 (2D) 
47 (2F) 


48 (30) 


49 (31) 


93 (SD) 


101 (65) 


Bit Pattern 


] 


ee 


22 


] 
2 
] 


] 


44 


8 


20 


Field Name 


ENTIDNO 
RELIND 


CRAVOL 
CRAIDNO 
CRADEVT 
CRACRETS 


ENTYPE 


ENTNAME 


VOLSTMP 


VOLDVCHR 


Description 


Zeros. 
Control interval number of this record. 


Release indicator: 
0=Nonenhanced VSAM; 
!=Enhanced VSAM. 


CRA volume serial.! 

CRA control interval number. 
CRA device type. ! 

CRA creation time stamp. 


Zeros. 


9? 


Record type—'‘V. 
Record length. 


Number of variable-length fields that precede 
the pointer to an extension record. Always 
zero. 


Length of the fixed-length fields in this 
record, excluding any fixed-length fields 
following displacement 126 (7E). This value 
is always equal to the displacement from the 
beginning of the record to the pointer to an 
extension record. 


Volume serial number, filled with binary 
zeros on the right, of the volume described 
by this record. 


Volume time stamp, which indicates when 
the first VSAM data space was defined on 
this volume. 


Device characteristics. 


Byte Meaning 

0-3 Volume device type. 

4-7 Maximum device blocksize. 

8-9 Number of cylinders on this volume. 


10-11. Number of tracks per cylinder on this 
volume. 


12-13. Number of bytes per track on this 
volume. 


14 Number of bytes required for gaps 
and check bits for each keyed block 
other than the last block on a track 
for this volume.2 


15 Number of bytes required for gaps 
and check bits for the last keyed 
block on a track for this volume.2 


16 Number of bytes to be subtracted for 
a block that is not keyed.2 
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Volume Catalog Record Format 


Offset 


121 (79) 
122 (7A) 


123 (7B) 


Bytes and 
Bit Pattern 


1 
1 


4 


Field Name 


VOLRFLG 
SYSEXTDS 


Description 


17 Flags. Bits 0 through 6 are reserved. 
If bit 7 is set to 1, use tolerance factor 
on all blocks but the last to calculate 
the effective length of a block.2 


18-19 Tolerance factor to be used in 
calculating the effective length of a 
block. 


Volume record flags. 


Number of extents per suballocation-request 
allowed by the OS/VS system. 


Reserved 


The following field names identify information that is not contained in the volume 
catalog record; the information is derived from fields in the volume catalog record. 


127 (7F) 


131 (83) 


132 (84) 


1 


> 


1 


VL 


NODSPACE 


NODSET 


Number of data spaces on the volume—a 
count of the Data Space Group sets of fields. 


Number of data sets on the volume—a count 
of the Data Set Directory Entry sets of fields. 
The following six-byte entry contains control 
information for the sets of fields that 
follow it. 


Pointer to horizontal extension record. If this 
record is not continued on an extension 
record, this field contains zeros. 


Number of set-of-fields pointers that follow.3 


Note: The first set-of-fields pointer contains 
sequence number = 0 and type code = 0. 
When bytes 0 to 2 are nonzero, this 
set-of-fields pointer points to the first 
(vertical) extension record that contains free 
space. The set-of-fields pointer is called the 
ASPT—available-space pointer. When bytes 
0 to 2 are zero, the pointer is a dummy 
set-of-fields pointer—not available to be used 
to point to a set of fields. 


6-byte pointers to sets of fields within the 
record. 


Byte Meaning 
0 Reserved. 


1-2 Displacement of the set of fields from 
the beginning of all sets of fields in 
this record. 


3 Bits 0 and 1 are set to zero. If bit 1 is 
on, the set of fields associated with 
this pointer has been deleted; the 
code in bits 2 through 7 of this byte 
and the sequence number in bytes 4 
and 5, however, are kept. Bits 2 
through 7 contain a code,* describing 
the set of fields pointed to. 


4-5 Sequence number of the set of fields 
pointed to. 


Data Areas 511° 


Volume Catalog Record Format 


Bytes and 
Offset Bit Pattern Field Name Description 
VL 6-byte pointers to sets of fields contained 


in vertical Extension records. 
Byte Meaning 


0-2 Control interval number of the 
Extension record that contains this 
set of fields. 


3 Bits 0 and 1 are set to B‘10’. Bits 2 
through 7 contain a code describing 
the set of fields pointed to. 


4-5 Sequence number of the set of fields 
pointed to. 
1 Zeros if the catalog is not recoverable or if there is no associated CRA entry. 


2 This value is used to calculate overhead bytes for keyed blocks to provide for 
compatibility with the DEVTYPE macro instruction. Blocks used by VSAM are, 
however, not keyed blocks. 


3 Fields describing (a) the volume’s track-allocated/unallocated status, (b) each 
VSAM data space on the volume, and (c) each data set that resides ina VSAM 
data space are grouped into sets of fields. Pointers to each set of fields identify 
the type of information contained in each set of fields. 


4 If the pointer is associated with track status (space map) information, the code is 
5; with data-space information, the code is 6; with a data set directory entry, the 
code is 8. 


Space Map Set of Fields Format 


The tracks on a VSAM volume are allocated to a VSAM object, or are 
unallocated, as described by the Space Map set of fields. Each bit position 
describes one track as allocated (bit = 0) or unallocated (bit = 1). This set of 
fields is associated with a pointer that contains a type code of 5. 


Bytes and 
Offset Bit Pattern Field Name Description 
0 (0) 2 Control Information: 


Byte Meaning 


0 Count of the number of 
variable-length fields in this set of 
fields (X‘01’). 


| Hexadecimal displacement to the 
variable-length field, from the 
beginning of the set of fields (X‘02’). 


2 (2) VL BITMAP Portion of the volume bit map (1 to 440 bytes 
describing the allocated or unallocated status 
of 1 to 3520 tracks). 
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Data Space Group Set of Fields Format 


Each VSAM data space on the volume is described with a Data Space Group 
set of fields. This set of fields is associated with a pointer that contains a type 
code of 6. 


Offset 


0 (0) 


2 (2) 


10 (A) 
15 (F) 


16 (10) 
1711) 


20 (14) 


23 (17) 


Bytes and 
Bit Pattern 


2 


oeXX XXXX 


3 


Field Name 


DSCBTS 


DSCBPTR 
SPHDFLG 


NODSPEXT 
DSPSOPT 


DSPSSQ 


SPEXTENT 


Description 


Control information. 


Byte Meaning 


0 Count of the number of 
variable-length fields in this set of 
fields (X‘00’). 

| Hexadecimal displacement to the 


first variable-length field from the 
beginning of this set of fields 
(X‘55’). 
Format-1 DSCB time stamp, which indicates 
when the DSCB was created. The time stamp 


is part of the name given to the Format-1 
DSCB. 


CCHHR of the Format-1 DSCB. 
Data-space flags. 


Unique data space, that is, this data space 
contains all or part of only one VSAM 
object. 

Shared data space, that is, this data space 
contains all or part of two or more VSAM 
objects. 

Automatically built data space, that is, this 
data space was built during end-of-volume 
processing. 

This data space was built when the user 
issued an Access Method Services DEFINE 
CATALOG command. 

Reserved. 


Number of extents in this data space. 
Data-space creation space options. 


Track request, which indicates that primary 
space allocation is specified in tracks. 
Cylinder request, which indicates that 
primary space allocation is specified in 
cylinders. 

Reserved 


Secondary space allocation quantity by which 
space is to be extended if required. This value 
is taken either from an Access Method 
Services DEFINE command or from the first 
data set on this volume that caused space to 
be used. 


Sixteen 4byte extent descriptors in the form 
TTNN: 


TT—starting track number of the extent 
(relative to the beginning of the volume). 
NN—number of tracks in the extent. 
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Derived Data Space Information 


The following field names identify information that is expected, but not 
contained in, the Data Space Group set of fields. The information is derived 
from fields in the volume catalog record. 


Bytes and 
Offset Bit Pattern Field Name 
1 SPHDFLG 
sits s 
BAA lar 
2 NODSDSP 


Description 
Data space flags: 


A user catalog has extents within this data 
space—each CAXWA associated with the 
user contains the volume serial number of its 
catalog. 

A master catalog has extents within this data 
space—the master catalog’s volume is 
identified by a Data Set Directory Entry set 
of fields that contains a control interval value 
of 002. 


Number of data sets in the data space—this 
information is derived by searching each data 
set and index catalog record (pointed to by 
Data Set Directory Entry sets of fields and 
Cluster catalog records) for a volume 
information set of fields that contains the 
volume’s serial number. Each set of fields so 
identified is searched to determine if the data 
set or index has been allocated space in one 
of the data space’s extents. 


The following field names refer to information about an extent of the data space: 


Z TRKSUSED 
4 EXTSTART 
Z NOTRKEXT 
2 SNSPHD 

VL SPACEMAP 


Number of allocated tracks in the 
extent—the Space Map set of fields is 
scanned to determine the number of 
allocated tracks, based on the extent’s 
starting track number and total number of 
tracks (contained in SPEXTENT). 


Cylinder and track on which the extent 
begins—the extent’s TT value (contained in 
SPEXTENT) is converted to a CCHH value. 


Number of tracks in the extent—the extent’s 
NN value (contained in SPEXTENT). 


Sequence number of the set of fields that 
describes the extent’s data space—the 
sequence number of the Data Space Group 
set of fields. 


A variable-length space map that defines the 
allocated and unallocated space in the 
extent—the Space map set of fields is 
converted to the format of this 
variable-length field based on the extent’s 
starting track number and total length 
(contained in SPEXTENT). 
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Data Set Directory Entry Set of Fields Format 


Derived Data Set Information 


Each data set that resides in a VSAM data space on the volume is described 
with a Data Set Directory Entry set of fields. This set of fields is associated 
with a pointer that contains a type code of 8. 


Offset 
0 (0) 


2 (2) 


5(5) 


9(9) 


Bytes and 
Bit Pattern 


2 


3 


Field Name 


DSIDNO 


DSCRETS 


DSSUMTT 


Description 


Control information. 


Byte Meaning 

0 Count of the number of 
variable-length fields in this set of 
fields (X‘00’). 

1 Hexadecimal displacement to the 


first variable-length field from the 
beginning of this set of fields (X‘05’). 


Control interval number of the Data or Index 
catalog record that describes this data set or 
index. 


Data/index identifier creation timestamp. 
Initialized by DEFINE and never altered. 
Consists of the high-order 4 bytes of the 
TOD clock value. 


Sum of TT values converted from starting 
CCHHs of all extents of this data set on this 
volume. 


The following field names identify information that is expected, but not 
contained in, the Data Set Directory Entry set of fields. The information is 
derived from fields in the volume catalog record. 


Offset 


Bytes and 
Bit Pattern 


-XXX XXXX 


VL 


Field Name 


MODSEXT 
DSDIRFLG 


DSSPSN 


Description 
Number of data set extents on this volume. 


Flags: 


The Data or Index catalog record identifies 
the volume as a candidate volume—the Data 
or Index catalog record was searched and its 
volume information set of fields had zero 
extents. 


Reserved. 


A variable-length collection of 3-byte fields 
that identify each data space within which 
the data set has extents allocated to it—this 
information is obtained by converting each 
volume information set of fields’ extent 
descriptor’s (EXTENT) SS value (data space 
extent’s sequence number) so that the 
resulting 3-byte field is: 


Byte Meaning 


0-1 Sequence number of the Data Space 
Group set of fields. 
2 Number of extents (groups of 


contiguous tracks) assigned to the 
data set or index from the data space 
(limits: 1—255). 
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Extension Catalog Record Format 


The Extension record contains overflow information from another catalog 


record. 
Bytes and 

Offset Bit Pattern 
0(0) 1 
1(1) 3 
4(4) 1 
5(5S) 6 
11(B) 3 
14(E) 4 
18(12) 4 
22(16) 22 
44 (2C) 1 

45 (2D) 2 
47 (2F) 1 
48 (30) 1 


Field Name 


ENTIDNO 
RELIND 


CRAVOL 
CRAIDNO 
CRADEVT 
CRACRETS 


ENTYPE 


2 


Description 


Zeros. 
Control interval number of this record. 


Release indicator: 
0 = Nonenhanced VSAM; 
1 = Enhanced VSAM. 


CRA volume serial.! 

CRA control interval number. 
CRA device tye.! 

CRA creation time stamp. 
Zeros. 


Record type—a “W” if this Extension record 
is an extension of a Volume record; an “E”’ if 
this Extension record is an extension of any 
other record.2 


Record length. 


Number of variable-length fields that precede 
the pointer to an Extension record. Always 
zero. 


Length of the fixed-length fields in the 

header fields, excluding any fixed length 

fields following displacement 48 (30). This 

value is always equal to the displacement J 
from the beginning of the record to the 

extension record’s pointer. 


The following 6-byte entry contains control information for the sets of fields that follow 


il. 


49 (31) 5 
54 (36) 1 
55 (37) VL 


Pointer to horizontal Extension record. If 
this record is not continued on an Extension 
record, this field contains zeros. 


The number of set-of-fields pointers that 
follow.3 


Note: The first set-of-fields pointer contains 
sequence number = O and type code = 0. 
When bytes 0 to 2 are nonzero, this 
set-of-fields pointer points to the first 
(vertical) extension record that contains free 
space. The set-of-fields pointer is called the 
ASPT—available-space pointer. When bytes 
0 to 2 are zero, the pointer is a dummy 
set-of-fields pointer—not available to be used 
to point to a set of fields. 


5-byte pointers to sets of fields within the 
record.4 


Byte Meaning 
0 Reserved. 


1-2 Displacement of the set of fields from 
the beginning of all sets of fields in 


this record. ) 
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Extension Catalog Record Format 


Bytes and 
Offset Bit Pattern Field Name Description 


3 Bits O and 1 are set to zero. If bit 1 is 
on, the set of fields associated with 
this pointer has been deleted; the 
code in bits 2 through 7 of this byte 
and the sequence number in byte 4, 
however, are kept. Bits 2 through 7 
contain a code describing the set of 
fields pointed to.4 


4 Sequence number of the set of fields 
pointed to. 


If the record type is “‘W,”’ the sequence number length is two bytes. If the record type is 
not “W,” the sequence number length is one byte. 


VL 5-byte pointers to sets of fields contained in 
vertical Extension records.4 


Byte Meaning 


0-2 Control interval number of the 
Extension record that contains this 
set of fields. 

3 Bits 0 and 1 are set to B‘10’. Bits 2 


through 7 contain a code that 
describes the set of fields pointed to.4 


4 Sequence number of the set of fields 
pointed to by code. 4 
If the record type is ‘‘W,’’ the sequence number length is two bytes. If the record type is 
not ‘‘W,’’ the sequence number length is one byte. 


1 Zeros if catalog is not recoverable or if there is no associated CRA volume. 


2 The sets of fields that are contained in an Extension record depend upon the 
kind of catalog record that is extended. The format of the remainder of an 
Extension record is, therefore, variable. The sets of fields in an Extension record 
will, however, follow the same pattern as they would in the base record. 


3 Fields describing (a) the volumes on which a data set resides, and (b) the 
password information associated with a data set are grouped into sets of fields. 
Pointers to each set of fields identify the type of information contained in each 
set of fields. 


4 If the pointer is associated with volume information, the code is 3; or with 
password information, the code is 4. Sets of fields with codes 1 and 2 are never in 
an extension record. 
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CRA Free Record Format 


The CRA Free record indicates that the control interval in which it resides is 

free and points to the next control interval that is free because of deletion. 

Note that the Free CRA record is used only to mark a record that was used 2 
and has been deleted. The free space (control intervals) in the CRA that has 

never been assigned is not represented by Free CRA records. Control 

intervals 1, 4, 6, 7, and 8 in the CRA are marked as Free records; however, 


their Free control interval chain field is zero. 


Bytes and 
Offset Bit Pattern Field Name Description 
0(0) 1 Reserved. 
1(1) 3 ENTIANO Control interval number of this record: 
X*OOO00N’ where N = 1, 4, 6, 7, or 8. 
4(4) 40 Reserved. 
44(2C) 1 ENTYPE Record type—‘‘F..”’ 
45(2D) 3 Free control interval chain field 
48(30) 457 Reserved. 
CRA Data Record Format 


The CRA Data record describes the CRA data component of the CRA 
cluster. The CRA Data record, which is record type “‘D’’, occupies control 
interval 9 in the CRA. 


Bytes and 
Offset Bit Pattern Field Name Description 
0(0) | Zeros. ) 
1(1) 3 ENTIDNO Control interval number of this record: 
X‘000000.’ 
4(4) | RELIND Release indicator: 
0 = Nonenhanced VSAM; 
1 = Enhanced VSAM. 
5(5) 39 Zeros. 
44(2C) 1 ENTYPE Record type—‘‘D.”’ 
45(2D) 2 Record length. 
47(2F) 1 Number of variable-length fields that precede 
the pointer to an extension record. Always 
zero. 
48(30) 1 Length of nonrepeating, fixed-length fields. 
Always X‘8F.’ 
49(31) 44 ENTNAME Name of the catalog that owns this CRA 
volume. 
93(SD) 8 OWNERID Initialized to all X‘FF.’ 
101(65) 3 DSETCRDT Date CRA was created. In packed decimal 
form YDD. 
104(68) 3 DSETEXDT Expiration date. Initialized to X‘OQOOOF.’ 
107(6B) | ATTRI Data set attributes: X‘00.’ 
108(6C) | ATTR2 Data set attributes: X‘AO.’ 
109(6D) | OPENIND Open indicator: X‘00.’ 
| 
110(6E) 4 BUFSIZE Minimum buffer size: X‘°800.’ J 


518 OS/VS2 SVS Independent Component: Virtual Storage Access Method (VSAM) Logic 


CRA Data Record Format 
Bytes and 

Offset Bit Pattern Field Name Description 

114(72) 3 PRIMSPAC Primary space. Initialized to number of 
tracks per cylinder. 

117(75) 3 SCONSPAC Secondary space. Initialized to number of 
tracks per cylinder. 

120(78) 1 SPACOPTN Space option: X‘80.’ 

121(79) 4 HURBADS High-used RBA. 

125(7D) 4 HARBADS High-allocated RBA. 

129(81) 4 LRECL Logical record size: X‘IF9.’ 

133(85) 2 USERINFO DOS user information: X‘00.’ 

135(87) 8 EXCPEXIT Exception exit: initialized to all X‘FF.’ 

The following entries contain control information for repeating fields: 

143(8F) 5 Pointer to an extension record. Always zeros. 

148(94) 1 The number of set-of-field pointers that 
follow. 

149(95) VL Five-byte pointers to sets of fields. 


AMDSB (Access Method Data Statistics Block) Set of Fields 


Format 


The AMDSB set of fields contains a copy of the AMDSB control block that is 
updated each time the CRA is closed. This set of fields is associated with a 
pointer that contains a type (group) code of 1. 


Bytes and 
Offset Bit Pattern Field Name Description 
0(0) 2 Control information. 
Byte Meaning 
0 Count of number of 
variable-length fields in this set of 
fields. 
1 Displacement (X‘62’) to the first 


variable-length field from the 
beginning of this set of fields. 


2(2) 96 AMDSBCAT Copy of the AMDSB. See “‘Data Areas”’ for 
detailed information about the AMDSB. 


Association (Cluster) Set of Fields Format 


There is one association in this entry, and it has a group occurrence sequence 
number of 1. 


Bytes and 
Offset Bit Pattern Field Name Description 
0(0) 2 Control information: X‘0006.’ 
2(2) 1 TYPE Record type—‘C.’ 
3(3) 3 NAME Control interval number: X‘000002.’ 
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Volume Information Set of Fields 


There is one volume information set of fields in this entry. Its group 
occurrence sequence number is 1, and it resides in control interval number 5. } 


CRA Cluster Record Format 


This record describes the CRA cluster. It is record type “‘C,”’ and it occupies 
control interval 2 in the CRA. 


Bytes and 

Offset Bit Pattern Field Name Description 

0(0) | Zeros. 

1(1) 3 ENTIDND Control interval number of this record: 
X‘000002.’ 

4(4) 1 RELIND Release indicator: 
Q = Nonenhanced VSAM; 
1 = Enhanced VSAM. 

5(5) 39 Zeros. 

44(2C) 1 ENTYPE Record type—‘C.’ 

45(2D) 2 Record length. 

47(2F) 1 Number of variable-length fields that precede 
the pointer to an extension record. Always 
zero. 

48(30) 1 Length of nonrepeating fixed-length fields: 
X‘6C,’ 

49(31) 44 ENTNAME Name of the catalog that owns this CRA 
volume. 

93(S5SD) 8 OWNERID Initialized to all X‘FF.’ J 

101(65) 3 DSETCRDT Date CRA was created. In packed-decimal 
form YDD. 

104(68) 3 DSETEXDT Expiration date. Initialized to X‘OOOOOF.’ 

107(6B) 1 CATTR Cluster attributes: X‘00.’ 

The following entries contain control information for repeating fields. 

108(6C) 5 Pointer to an extension record. Always X‘00.’ 

113(71) | The number of set of field pointers that 
follow. 

114(72) VL Five-byte pointers to sets of fields. 


Association (Data) Set of Fields Format 


There is one association in this entry, and its group occurrence sequence number is 1. 


Bytes and 
Offset Bit Pattern Field Name Description 
0(0) 2 Control information: X‘0006.’ 
2(2) | TYPE Record type —"“D.” 
3(3) 3 NAME Control interval number: X‘000000.’ 


520 OS/VS2 SVS Independent Component: Virtual Storage Access Method (VSAM) Logic 


Se 


L 


CRA Catalog Control Record Format 


The catalog control record is used to manage CRA control interval allocation. 
It is record type “‘L,” and it occupies control interval 3 in the CRA. 


Offset 


0(0) 
1(1) 


4(4) 


5(5) 
44(2C) 
45(2D) 


48(30) 


51(33) 
54(36) 


57(39) 
61(3D) 
65(41) 
69(45) 


Bytes and 


Bit Pattern Field Name 


1 
3 ENTIDNO 


1 RELIND 


39 
| ENTYPE 


436 


CRA Data Extension Record Format 


The Data Extension record is the extension of the CRA Data Record in 
control interval 0 of the CRA. The Data Extension record is record type “E,” 
and it occupies control interval 5 in the CRA. 


Offset 
0(0) 
1(1) 


4(4) 


5(5) 


44(2C) 


45(2D) 
47(2F) 


48(30) 


Bytes and 

Bit Pattern Field Name 
1 
3 ENTIDNO 
1 RELIND 

39 

1 ENTYPE 
2 


Description 


Zeros. 

Control interval number of this record: 
X‘000003.’ 

Release indicator: 


0 = Nonenhanced VSAM. 
1 = Enhanced VSAM. 
Zeros. 


Record type—'"L. 


Number of the highest control interval within 
the current extents. 


Number of the next free control interval that 
has not been previously assigned. 


Number of deleted control intervals. 


First deleted control interval in a chain of 
control intervals that are free because of 
deletion. 


Reserved. 
CRA data high-used RBA. 
CRA data high-allocated RBA. 


Reserved. 


Description 


Zeros. 

Control interval number of this record: 
X‘000005.’ 

Release indicator: 


0 = Nonenhanced VSAM; 
1 = Enhanced VSAM. 


Zeros. 
Record Type—‘E.”’ 
Record length. 


Number of variable length field that precede 
the pointer to an extension record. Always 
zero. 


Length of non-repeating fixed length fields: 
X‘6C’ 


The following entries contain control information for repeating fields: 


49(31) 


5 


Pointer to an extension record. Always zeros. 
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CRA Data Extension Record Format 


Bytes and 
Offset Bit Pattern Field Name Description 
54(36) 1 The number of sets-of-fields pointers that 
follows. 
55(37) VL 5-byte pointers to sets of fields within the 
record. 


Volume Information Set of Fields Format 


There is one volume information set of fields in this entry, and its group 
occurrence sequence number is 1. 


Bytes and 
Offset Bit Pattern Field Name Description 
0(0) 2 Control information: X‘0327.’ 
2(2) 4 DEVTYP Device type. 
6(6) 6 VOLSER Volume serial number. 
12(C) 2 FILESEQ File sequence number. 
14(E) 1 VOLFLG Volume flags: X‘80.’ 
15(F) 1 NOEXTNT Number of extents. 
16(10) 4 HKRBA High-key RBA. 
20(14) 4 HURBA High-used RBA. 
24(18) 4 HARBA High-allocated RBA. 
28(1C) 4 PHYBLKSZ Block size: X‘200.’ 
32(20) Z NOBLKTRK Number of blocks per track. 
34(22) 2 NOTRKAU Number of tracks per allocation unit. 
Initialized to number of tracks per cylinder. 
36(24) | ITYPEXT Type-of-extent indicator. 
37(25) 2 DSDIRSN Data set directory sequence number. 
39(27) 2 LOKEYV Low key value on volume. 
41(29) 2 HIKEYV High key value on volume. 
43(2B) 2 EXTENT Length of extent information 
45(2D) VL 20-byte extent descriptors. 
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Field-Name Dictionary 


The field-name dictionary is an internal data area that provides a map 
between field names and fields within catalog records, as well as information 
that is not within catalog records. The dictionary also allows the dictionary 
user to specify values (for example, the number of sets of fields to be 
processed) by associating them with a dictionary name. A field name is 
specified in a CTGFL (field parameter list); for a description of the CTGFL, 
see ‘““Data Areas.” The catalog-management modules reference the field-name 
dictionary for the location, length, and type of fields. 


The field-name dictionary is a series of 8-byte entries. In addition, there is an 
index of combination field names. Each combination field name allows 
catalog management to locate more than one field at a time. 


The field-name dictionary is located in module IGGOCLAY. 


Bytes and 
Offset Bit Pattern Description 


0 4 Shortened field name: the first, second, fifth, and sixth 
characters of the eight-character field name. 


4 1 Flags that describe the field: 


O00. .... The field is fixed-length and appears in the header portion 
of a record (before the Extension record pointer). 
001. .... A combination field name. ! 
010. .... The field is fixed-length and is part of a set of fields that 
follows the Extension record pointer. 
100. .... The field is variable-length and appears in the header 
portion of a record (before the Extension record pointer). 
110. .... The field is variable-length and is part of a set of fields 
that follows the Extension record pointer. 
O1l..... Special field? 
10 be eae Special field2 
ey, | ae Not a flag field, which means that a CLC (compare logical 
character) instruction can be used to test this field. 
ie Be Flag field, which means that a TM (test under mask) 
instruction can be used to test this field. 
ai lire A fixed-length field within a variable-length field in a set 
of fields. 
Diss Not a fixed-length field within a variable-length field in a 
set of fields. 
wide oles CRA updates are to be suppressed. 
“20.2 CRA updates are not suppressed. 
1 This field must be retrieved from the upgrade set. 
..0. This field has no special retrieval characteristics. 
Soke ita X Reserved 


5 1 Bytes that identify the location of the field: 


Type of Contents of 
Field Name: This Byte: 


Fixed-length: Displacement in bytes from the 
In the header: Beginning of the record. 


In a set of 
fields: Beginning of the set of fields. 


In a group of 

fixed-length 

fields within 

a variable-length 

field: Length of the group of 
fixed-length fields. 


Variable-length: Zero. 
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Combination Field Names 


Field-Name Dictionary 


Bytes and 
Offset Bit Pattern Description 
Combination: Index value in the 
combination-name index. 
6 1 Bytes that identify the location of the field (continued): 
Type of Contents of 
Field Name: This Byte: 
Fixed-length: Length of the field (in bytes). 
Variable-length: Sequence number of the field. 
Combination: Number of fields identified by 
the combination name. 
7 1 A code that indicates which group of data (the kind of 


catalog record and the set of fields) this field is in. 
Type Code: Description: 


Header field 
AMDSB 
Association 

Volume information 
Password 

Space map 3 

Data space group 3 
Reserved 

Data set directory? 


1 “Combination field name” indicates that the name supplied is a name that allows 
catalog management to locate a group of related fields. 


2 The field-name dictionary permits catalog management to locate information 
that is not contained in catalog records. 


3 This set of fields is contained only in a Volume catalog record. 


Bytes 4 through 7 of the field-name dictionary record describe the field. 
When a caller specifies catalog information with an CTGFL, dictionary 
information is moved into the CTGFL. 


To clarify the use of the dictionary as a means of gaining access to catalog 
information, refer to the examples that follow. 


A combination field name identifies a group of related fields. When a catalog 
management user requires information from many catalog record fields (for 
example, all fields in a set of fields), the user builds a CTGFL that contains a 
combination field name. The combination field name in the CTGFL identifies 
an entry in the field name dictionary (in module IGGOCLAY). The entry 
identifies the field name as a combination field name, specifies the number of 
fields contained in the combination, and points to the starting point for the 
combination in the combination field name index. The combination field 
name index contains a group of 1-byte entries. Each entry points to an entry 
in the field name dictionary, as shown in Figure 60, Resolution of a 
Combination Field Name. The entry in the field name dictionary describes 
one of the fields identified by the combination. 
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Figure 60. Resolution of a Combination Field Name 


Extent 
of the 
Combination 


Field Name Dictionary Entries 


This section lists the field name dictionary entries in alphabetic order. 
IGGOCLAY lists the field name dictionary entries in alphabetic order, too, 
but that list is ordered by abbreviated field name. The field’s name, length, 
location, and description are listed here. 


The length is a number of bytes. If the field is variable-length, the code ‘VL’ 
is used. If the name is a combination name, the length might be indeterminate. 
The field’s length (Len) is: 


- ‘n’—a number of bytes. 


- ‘VL’—indeterminate, because the field is a variable-length field. 


é 


- ‘—’——indeterminate, because the combination-name group of fields 
includes one or more variable-length fields. 


The field’s location is coded as follows: 


Code Location description 

AMDSB The AMDSSB set of fields 

Assoc The association set of fields 

Combin A combination field name 

Header The catalog record’s header fields. Note: some header fields appear in 


all catalog records; other header fields appear only in one (or more) 
type of catalog record. 


Password The password set of fields 

Special A piece of information that is derived from information in catalog 
record fields or catalog control blocks, but is not stored in a catalog 
record 

Vol Info The volume information set of fields 

Vol-Dir The data set directory entry set of fields in the volume catalog record 

Vol—-DSG The data space group set of fields in the volume catalog record 

Vol-SM The space map set of fields in the volume catalog record 

Notes: 


e The list of field names following each combination name in this section is 
ordered alphanumerically. See module listing IGGOCLAY for the actual 
order of the combination’s field names. 
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e Each variable-length field contains two bytes of control information 
followed by a number of data bytes. The 2-byte control information 
specifies the total length of the field (the number of data bytes). 


Field 
Name 


AMDCIREC 


AMDKEY 


AMDSBCAT 
AMDSBSC 


AMDSB1 
AMDSB2 
AMDSB3 
ASSOCSC 
ATTRI1 
ATTR2 
BITMAP 


BUFSIZE 
CATACB 
CATTR 

CATVOL 


CNTREPNO 


CRACRETS 
CRADEVT 
CRADIRCT 


CRADITS 
CRAIDNO 
CRAVOL 
DATASPAC 


DEVTYP 
DEXTENTS 


DIRECTRY 


Len 


8 


10 
68 


VL 


68 


Location 


AMDSB 


AMDSB 


AMDSB 


Combin 


AMDSB 
AMDSB 
AMDSB 
Combin 
Header 

Header 

Vol-SM 


Header 
Special 
Header 


Combin 


Special 


Header 
Header 


Combin 


Header 
Header 
Header 


Combin 


Vol Info 


Combin 


Combin 


Description 
AMDSB control-interval size and maximum 
logical record size (Show Catalog support) 


AMDSSB relative key position and key length 
(Show Catalog support) 


Copy of the AMDSB control block 

AMDSSB fields for Show Catalog 

Includes fields: AMDCIREC, AMOKEY 
Part of AMDSB 

Part of AMDSB 

Part of AMDSB 

Twin associations for Show Catalog support 
Data set attributes 

Data set attributes 


Volume space map showing the allocated and 
unallocated tracks on a direct-access volume 


Minimum buffer size 
Address of the catalog’s ACB control block 
Cluster attributes 


Volume information set of fields for a 
nonVSAM data set’s catalog record 


Includes fields: DEVTYP, FILESER, 
RELREPNO, VOLFLG, VOLSER 


Maximum number of RELREPNOs to be 
processed 


CRA creation timestamp 
CRA device type 
Data set directory fields for Catalog Recovery 


Includes fields: DSCRETS, DSIDNO, 
DSSUMTT, RELREPNO 


Data/index identifier creation timestamp 
CRA control interval number 

CRA volume serial 

Data space group set of fields 


Includes fields: DSCBPTR, DSCBTS, 
DSPSOPT, DSPSSQ, NODSPEXT, 
SPEXTENT, SPHDFLG, RELREPNO 


Device type 


All fields in the data space group set of fields 
required by Suballocate processing 


Includes fields: NODSPEXT, SPEXTENT, 
SPHDFLG, RELREPNO 


Data set directory entry set of fields 


In-ludes fields: DSIDNO, RELREPNO 
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Field Name Dictionary Entries 


Field 
Name 


DSATRO 


DSATTR 


DSCBPTR 
DSCBTS 


DSCBTTR 


DSCRETS 
DSDIRECT 


DSDIRFLG 
DSDIRSN 


DSETCRDT 
DSETEXDT 
DSIDNO 


DSPDSCRP 


DSPSOPT 
DSPSSQ 


DSSPSN 


DSTYPNAM 


DSSUMTT 


ENTASSOC 
ENTIDNO 


ENTNAME 
ENTUPGD 


ENTVOL 


Len 


ww 


13 


VL 


37 


Location 


Combin 


Combin 


Vol—-DSG 
Vol—-DSG 


Vol Info 


Vol-Dir 


Combin 


Special 
Vol Info 


Header 
Header 
Vol-Dir 


Combin 


Vol-DSG 
Vol-DSG 


Special 


Combin 


Vol-Dir 


Combin 
Header 


Header 


Combin 


Combin 


Description 


All data set attributes flags fields 
Includes fields: ATTR1, ATTR2, OPENIND 


All data set attributes flags fields, except the 
open indicator 


Includes fields: ATTR1, ATTR2, OPENIND 


TTR of the DSCB that describes the data space 
in the volume’s VTOC 


Data space timestamp 


TTR of the format 1 (identifier) DSCB that 
describes the space allocated to anonVSAM 
data set 


Data/index identifier timestamp 


Data set directory entry set of fields, including 
some of the related derived fields 


Length: 7 + |’ DSSPSN 


Includes fields: DSDIRFLG, DSIDNO, 
DSSPSN, NODSEXT, RELREPNO 


Data set directory flags (derived) 


Data set directory sequence number in the 
volume informationset of field’s extent 
descriptor 


Data set creation date 
Data set expiration date 


Control interval number of the data set directory 
entry’s object’s catalog record 


Space descriptor set of fields (a group of derived 
fields) 


Includes fields: EXTSTART, NOTRKEXT, 
RELREPNO, SNSPHD, SPACEMAP, 
TRKSUSED 


Space options for a data space 

Secondary data space quantity 

Data space sequence numbers for the data set 
directory entry set of fields (derived) 

Catalog record type and dsname 

Includes fields: ENTIDNO, ENTYPE 


Sum of starting tracks of all extents of data set 
on this volume 


Association set of fields 

Includes fields: NAME, RELREPNO, TYPE 
Control interval number of the catalog record 
Dsname in the catalog record 

Combination for associations in the upgrade set 


Includes fields: NAME, NAME2, RELREPNO, 
TYPE, TYPE2 


Volume information set of fields 
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Field Name Dictionary Entries 


Field 
Name 


ENTYPE 
EXCPEXIT 
EXTENT 
EXTSTART 


EXTVOL 


FILESEQ 


GENDSP 
HARBA 


HARBADS 


HIKEYV 


HKRBA 


HKURBA 


HURBA 
HURBADS 


ITYPEXT 
LOKEYV 


LRECL 
MAPSPACE 


NAME 
NAMEZ2 


NAMEDS 


Len 


> 


VL 


Location 


Header 
Header 
Vol Info 
Special 


Combin 


Vol Info 


Special 
Vol Info 


Header 


Vol Info 


Vol Info 


Combin 


Vol Info 
Header 


Vol Info 
Vol Info 


Header 


Combin 


Assoc 


ASSOC. 


Combin 


Description 


Includes fields: DEVTYP, FILESEQ, HARBA, 
HKRBA, HURBA, ITYPEXT, NOBLKTRK, 
NOEXTNT, NOTRKAU, PHYBLKSZ, 
VOLFLG, VOLSER, RELREPNO, DSDIRSN, 
EXTENT, HIKEYV, LOKEYV 


Catalog record type identifier 
Exception exit 
Extent descriptors 


Starting point in the list of data space extents in 
the data space group set of fields (derived) 


Volume information set of field’s fields required 
for VSAM End of Volume processing 


Length: 7 + ! EXTENT 


Includes fields: DEVTYP, EXTENT, ITYPEXT, 
RELPERNO 


File sequence number for a nonVSAM data set 
Includes fields: NAME, TYPE 
Generated data space dsname 


High-allocated RBA on the volume for the data 
set 


High-allocated RBA for the data set (not always 
the same as HARBA if the data set resides on 
several volumes) 


Key-sequenced data set’s high key value ona 
volume or, if the data set is divided into key 
ranges, the key range’s high key value 


RBA of the record containing the high key of a 
key-sequenced data set on a volume or, if the 
data set is divided into key ranges, the key 
range’s high key value 


Data set’s high-key and high-used RBAs 
Includes fields: HKRBA, HURBA 
High-used RBA on the volume for the data set 


High-used RBA for the data set (not always the 
same as HURBA if the data set resides on 
several volumes) 


Type of extent indicator 


Key-sequenced data set’s low-key value on a 
volume or, if the data set is divided into key 
ranges, in the key range 


Average logical record size 

Volume catalog record’s space map set of fields 
Length: 2 + | BITMAP 

Includes fields: BITMAP, RELREPNO 
Control interval number 


Control interval number of index in twin 
association of upgrade set 


Association set of fields 
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Field Name Dictionary Entries 


Field 
Name 


NOBLKTRK 
NOBYTTRK 
NODSDSP 
NODSET 
NODSEXT 
NODSPACE 
NODSPEXT 
NOEXTNT 


NONVOL 


NOTRKAU 
NOTRKEXT 


OPENCNT 
OPENC2 


OPENIND 
OPNCALLI 


OWNERID 
PASSATMP 


PASSPRMT 


PASSWALL 


PASSWORD 
PHYBLKSZ 
PRIMSPAC 
RELCRA 


RELIND 
RELREPNO 
REPNO 
RGATTR 


Len 


Ny NY ff WN 


16 


53 


Nn NM 


Location 


Vol Info 
Vol Info 
Special 
Special 
Special 
Header 


Vol-DSG 


Vol Info 


Combin 


Vol Info 


Special 


Header 


Combin 


Header 


Combin 


Header 


Password 


Password 


Combin 


Password 
Vol Info 
Header 


Combin 


Header 
Special 
Special 
Header 


Description 


Includes fields: NAME, TYPE 

Number of blocks per track 

Number of bytes per track 

Number of data sets in a data space (derived) 
Number of data sets on a volume (derived) 
Number of data set directory extents (derived) 
Number of data spaces on a volume (derived) 
Number of data space extents 


Number of volume information set of field’s 
extents 


NonVSAM data set’s volume information set of 
fields 


Includes fields: DEVTYP, DSCBTTR, 
FILESEQ, RELREPNO, VOLFLG, VOLSER 


Number of tracks per allocation unit 


Number of tracks in a data space’s extent 
(derived) 


Open count 
Catalog fields required by OPEN 


Includes fields: BUFSIZE, ENTNAME, 
EXCPEXIT, HURBADS, SPACOPTN 


Open indicator 


All header fields required by VSAM Open 
processing 


Includes fields: BUFSIZE, ENTNAME, 
HURBADS, SPACOPTN 


Owner identification number 


Number of attempts the operator has to supply 
the correct password 


Data set’s prompting name (codename) for 
security verification 


Password set of fields 
Length: 50 + l USERAREC 


Includes fields: PASSATMP, PASSPRMT, 
PASSWORD, USERAREC, USVRMDUL 


All (4) 8-byte passwords 

Physical blocksize 

Primary space allocation amount 
Release indicator and CRA header fields 


Includes fields: CRADEVT, CRAIDNO, 
CRAVOL, RELIND 


Release indicator 
Relative repetition number 
Highest nondeleted sequence number 


Path/alternate index indicator 
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Field Name Dictionary Entries 


Field 
Name 


SCONSPAC 
SLOCVOL 


SNSPHD 


SPACEHDR 


SPACEMAP 
SPACOPTN 
SPACPARM 


SPEXTENT 
SPHDFLG 
SYSEXTDS 


TOENTVOL 


TRBAEXT 
TRKSUSED 
TYPE 
TYPE2 


UPDVOL 


UPGRADE 


USERAREC 
USVRMDUL 


VOLDEV 


Len 


23 


64 


43 


VL 


12 


Location 


Header 


Combin 


Special 


Combin 


Special 
Header 


Combin 


Vol-DSG 
Vol-DSG 
Header 


Combin 


Vol Info 
Special 
Assoc 


Assoc 


Combin 


Combin 


Password 


Password 


Combin 


Description 


Secondary space allocation amount requirement 
Fields required by Superlocate 


Includes fields: DEVTYP, DSCBTTR, 
FILESEQ, ITYPEXT, RELREPNO, VOLFLG, 
VOLSER 


Data space sequence number for a data space 
(derived) 


Data space group set of fields 


Includes fields: DSCBPTR, DSCBTS, 
DSPSOPT, DSPSSQ, NODSDSP, NODSPEXT, 
RELREPNO, SPHDFLG 


Data space run length codes (derived) 
Space options 
Space allocation quantities and options 


Includes fields: PRIMSPAC, SPACOPTN, 
SCONSPAC 


Data space extent descriptors 
Data space flag (partially derived) 


Number of extents allowed per 
suballocation—in the volume catalog record 


Track overflow entire volume 


Includes fields: DEVTYP, DSDIRSN, 
EXTENT, FILESEQ, HARBA, HIKEYV, 
HKRBA, HURBA, ITYPEXT, LOKEY, 
NOBLKTRK, NOBYTAU, NOBYTTRK, 
NOEXTNT, NOTRKAU, PHYBLKSZ, 
RELREPNO, VOLFLG, VOLSER 


Test RBA for EOV mount by RBA 
Tracks used in the data space (derived) 
Association entry type 


Entry type for second name of a twin association 
in the upgrade set 


Volume information set of fields for 
UPDATE-Extend processing 


Length: 43 + lHIKEYV + l’LOKEYV 


Includes fields: DEVTYP, DSDIRSN, 
FILESEQ, HARBA, HIKEYV, HKRBA, 
HURBA, ITYPEXT, LOKEYV, NOBLKTRK, 
NOEXTNT, NOTRKAU, PHYBLKSZ, 
RELREPNO, VOLFLG, VOLSER 


Fields for a twin association in the upgrade set 
Includes fields: TYPE, NAME, TYPE2, NAME2 
Additional security verification data 


USVR (user security verification routine) 
module name 


Volume information set of fields required by 
VSAM Open processing 
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Dictionary Example 1 


Dictionary Example 2 


Field Name Dictionary Entries 


Field 

Name Len Location Description 
Includes fields: DEVTYP, NOBLKTRK, 
NOTRKAU, PHYBLKSZ 

VOLDVCHR 20 Header Device characteristics—in the volume catalog 
record 

VOLEXT — Combin Volume information set of fields 
Length: 10 + 1 EXTENT 
Includes fields: DSDIRSN, EXTENT, 
RELREPNO, VOLSER 

VOLFLG 1 Vol Info Volume information flags 

VOLPHY — Combin Volume information set of fields required by 
VSAM Open processing 
Length: 23 + VTEXTENT + lHIKEYV + 
’LOKEYV 
Includes fields: EXTENT, HARBA, HIKEYV, 
HKRBA, HURBA, ITYPEXT, LOKEYV, 
NOEXTNT, RELREPNO, VOLFLG, VOLSER 

VOLRFLG 1 Header Volume catalog record flags 

VOLSER 6 Vol Info Volume serial number 

VOLTSTMP 8 Header Volume catalog record timestamp 


The DSETCRDT (data set creation date) field appears in the dictionary, as 
follows: 


DSETCRDT,0,101,3,0 


The first 0 is the fourth byte value of the record; it indicates that 
DSETCRDT is (a) a fixed-length field, (b) not part of a set of fields, and (c) 
not a flag field. 


The 101 (decimal) is the fifth-byte value of the record; it indicates, when 
converted to hexadecimal, that DSETCRDT is at displacement X‘65’ from 
the beginning of the record in which it appears. 


The 3 is the sixth-byte value of the record; it indicates that DSETCRDT is 
three bytes long. 


The last 0 is the seventh-byte value of the record; it is zero because 
DSETCRDT is not part of a set of fields and, therefore, is not associated with 
a set of fields code. 


The DSPSOPT (data-space-creation space options) field appears in the 
dictionary, as follows: 


DSPSOPT,80,19,1,6 


The 80 (X‘50’) is the fourth-byte value of the record; it indicates, when 
converted to binary, that DSPSOPT is (a) a fixed-length field that is part of a 
set of fields, (b) a flag field, and (c) not a repeating field within a 
variable-length field. 
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The 19 is the fifth-byte value of the record; it indicates, when converted to 
hexadecimal, that DSPSOPT is at displacement 13 from the beginning of the 
set of fields to which it belongs. 


The 1 is the sixth-byte value of the record; it indicates that DSPSOPT is 1 
byte long. 


The 6 is the seventh-byte value of the record; it indicates that DSPSOPT is 
part of a set of fields associated with a code of 6, which means that it is part 
of a set of fields that contains VSAM data-space information. 


Control Block Interrelationships 


Figures 61 and 62 show the VSAM control blocks built when a 
key-sequenced data set is opened. 


The role of the BIB and CMB in virtual-storage management is described in 
“Virtual-Storage Management”’ in “Diagnostic Aids.” 
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Note: The data control block structure is shown in Figure 66. The index control block structure is shown in Figure 68. 


Figure 61. VSAM Control Block Structure for a Key-Sequenced Data Set (VSAM User) 
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Note: The data control block structure is shown in Figure 66. 
The index control block structure is shown in Figure 68. 


Figure 62. VSAM Control Block Structure for a Key-Sequenced Data Set (ISAM User) 


Figure 63 shows how a VSAM cluster (OQURDATA) is shared between two 
subtasks (User#1 and User#2). When the cluster is opened by User#1, VSAM 
control blocks are built to describe the cluster to VSAM routines. When the 
cluster is opened by User#2, an AMBL is built to link User#2’s ACB to the 
cluster’s VSAM control blocks. When either subtask closes the cluster, the 
subtask’s AMBL is deleted. When the last subtask that is sharing the cluster 
closes it, the VSAM control blocks that describe the cluster to the VSAM 
routines are deleted. 
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Note: The data control block structure is shown in Figure 66. The index control block structure is shown in Figure 68. 


Figure 63. VSAM Data Set Control Blocks Before and After Data Set Sharing 
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Figure 64 shows the VSAM control blocks built when a key-sequenced data 
set (KSDS1) is opened for access through a path (PATH 1). The path 
alternate index (AIX1) and a second alternate index (A[X2) are members of 
the upgrade set for KSDS1. 


Figure 65 shows the sharing of VSAM control blocks when the 
key-sequenced data set (KSDS1) shown in Figure 64 is opened for access 
through a path (PATH2) with the second alternate index (AIX2). AMBLs 
are built to link User #2’s ACB to AIX2 and KSDS1. When either user closes 
his path, his AMBLs are deleted. 
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Note: The base data control block structure is shown in Figure 66. The alternate-index data control block structure is shown in 
Figure 67. The index control block structure is shown in Figure 68. 


Figure 64. VSAM Control Block Structure for a Key-Sequenced Data Set Accessed through a Path 
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Note: The base data control block structure is shown in Figure 66. The alternate-index data control block structure is shown in 
Figure 67. The index control block structure is shown in Figure 68. The BIB-UPT-RPL-ACB-upgrade AMBL structure is shown in 
Figure 68. The BIB-UPT-RPL-ACB-upgrade AMBL structure (not shown) is the same as in Figure 64. 


Figure 65. Shared VSAM Control Block Structure for a Key-Sequenced Data Set Accessed through Two Paths 
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Note: The index control block structure is illustrated in Figure 68. 


Figure 66. Data AMB Control Block Structure 


Figure 66 shows the control blocks that describe a cluster’s data component 
to VSAM record management routines. 
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Note: The base data control block structure is shown in Figure 66. The index control block structure is shown in Figure 68. 


Figure 67. Alternate-Index Data AMB Control Block Structure 


Figure 67 shows the control blocks that describe an alternate index’s data 
component to VSAM Record-Management routines. 
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Note: The data control block structure is illustrated in Figure 66. 


Figure 68. Index AMB Control Block Structure 


Q 
ro 
> 


CPA 


CPA 


Data Control 


Block Structure 


Buffer for 
Highest Level 
of Index 


Buffer for 
Other Levels 
of Index Set 


Buffer for 
Sequence Set 


Figure 68 shows the control blocks that describe a key-sequenced cluster’s 
index to VSAM record management routines. 
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Figure 69. Local Shared Resources Control Block Structure 


Figure 69 shows the VSAM control blocks built for processing with local 
shared resources (LSR). These control blocks describe the local VSAM 
resource pool. 
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Figure 70. AMB Control Block Structure with Local Shared Resources 


Figure 70 shows the AMB control block structure for processing with local 
shared resources (LSR). It differs from the structure for processing without 
shared resources, which is shown in Figures 66, 67, and 68. 
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Catalog Management Control Block Interrelationships 


Figure 71 shows the VSAM catalog management control blocks built when a 
{ VSAM routine calls catalog management to process a VSAM catalog record. 


Figure 72, Open Catalog Control Blocks, shows the OS/VS2 system and 
catalog management control blocks that describe a VSAM catalog to the 
OS/VS2 system. 
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Note: Figure 61 illustrates the contro] block structure of a key-sequenced VSAM data set. 
Figure 71. Catalog Management Control Blocks 


Figure 73, VSAM Control Blocks That Describe a Catalog (a key-sequenced 
key-range VSAM data set), shows the control blocks that describe the catalog 
as a data set. This control block structure allows record management to read 
and write control intervals in the catalog, and to update the catalog’s index, as 
required when catalog management I/O functions issue GET, PUT, and 
ERASE macro instructions. 
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Figure 72. Open Catalog Control Blocks 
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Figure 73. VSAM Control Blocks that Describe a Catalog (A Key-Sequenced, Key-Range VSAM Data Set) 
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VSAM Control Block Descriptions 


C ACB—Access Method Control Block 


The VSAM ACB describes a VSAM cluster. It is built by the user’s program. 
Before the cluster is opened, the ACB can be modified by the user’s DD 
statements and by the ACB exit routine. After the cluster is opened, the ACB 
is pointed to by the RPL (RPLDACB) that describes the user’s record 
processing request. 


Bytes and 
Offset Bit Pattern Field Name Description 
0 (0) 1 ACBID Control block identifier, X‘ AO’ 
1 (1) 1 ACBSTYP Subtype: 
X‘10’ = VSAM 
X‘20’ = VTAM 
2 (2) 2 ACBLENG Length of the ACB 
ACBLENG2 
ACBLEN2 
4 (4) 4 ACBAMBL Address of the AMBL 
ACBIXLST Address of the index list 
ACBJWA 
ACBIBCT 
8 (8) 4 ACBINRTN Address of the VSAM Interface routine 
(IDA019R1) 
12 (C) 2 ACBMACRF MACRF flags: 
Byte 1 ACBMACRI1 MACRF flag byte 1: 
1... ACBKEY The record is identified by a 
% key—keyed processing 
a es ACBADR The record is identified by a RBA 
ACBADD (relative byte address)—addressed 
processing 
a ACBCNV Control interval processing 
ACBBLK 
bee lis seg ACBSEQ Sequential processing 
Lee ACBDIR Direct processing 
“La ACBIN Input (GET, READ) processing 
soles ACBOUT Output (PUT, WRITE) processing 
eval ACBUBF User-supplied buffer space 
13 (D) Byte 2 ACBMACR2 MACRF flag byte 2: 
Soll; cobs ACBSKP Skip sequential processing 
i Pe ACBLOGON VTAM LOGON indicator 
sey ACBRST Set data set to empty state 
alts ACBDSN Basic subtask shared control block 
connection on common DSNAMEs 
Buel ACBAIX Entity to be processed is the alternate index 
of the path specified in the given DDNAME 
XXX. .... Reserved 
14 (E) 1 ACBBSTNO Number of concurrent strings for alternate 
index path 
15 (F) 1 ACBSTRNO Number of RPL strings 
16 (10) 2 ACBBUFND Number of buffers requested for data 
18 (12) 2 ACBBUFNI Number of buffers requested for index 
20 (14) 4 ACBBUFPL Address of the buffer header (BUFC) 
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ACB—Access Method Control Block 


Bytes and 
Offset Bit Pattern 
20 (14) 1 
1. 
j eee 
mi oe 
..0. 
eee 
MN xiacX 
21 (15) 1 
22 (16) 2 
24 (18) 1 
i i 
me Ie 
X.. XXXX 
25 (19) | 
mn.. .... 
.. mnnn 
..XX 
26 (1A) 2 
XX. sacs 
ay 
1... 
a 
weX XXXX 
XXXX .XXX 
28 (1C) 4 
32 (20) 4 
36 (24) 4 
Before OPEN 
40 (28) 8 
After OPEN 
40 (28) 2 
42 (2A) 1 
43 (2B) 1 
44 (2C) 1 
45 (2D) 3 


Field Name 


ACBMACR3 


ACBLSR 
ACBICI 
ACBDFR 
ACBSIS 
ACBNCFX 


ACBMACR4 
ACBJBUF 
ACBRECFM 


ACBRECAF 
ACBCPACD 


ACBPDIR 


ACBCCTYP 


ACBTRCID 
ACBASA 


ACBOPT 
ACBDSORG 


ACBCROPS 
ACBCRNCK 


ACBCRNRE 


ACBDVIND 
ACBOPT]J 


ACBDORGA 


ACBMSGAR 
ACBPASSW 


ACBEXLST 
ACBUEL 


ACBDDNM 


ACBTIOT 
ACBINFL 
ACBAMETH 
ACBERFL 
ACBDEB 


Description 


MACRF flag byte 3 


Local shared resources 

Improved control interval processing 
Write operations are to be deferred 
Sequential insert strategy 

Control blocks are not fixed 

Control blocks are fixed 

Reserved 


Reserved 
Number of buffers requested for journal 
Record format: 


JES format 

Compaction table must be passed (JES/RES) 
PDIR must be passed (JES/RES) 

Reserved 


Control character: 


3800 translate table identifier 
Control character type 
Reserved 


Non-user options 
Match ACBDORGA with DCBDSORG 


Byte 1: 
Checkpoint/restart options: 


Restart has not checked for notification since 
last checkpoint 

Data added since last checkpoint has not 
been erased by restart, and no reposition to 
last checkpoint takes place 

3800 device type indicator 


- 


Reserved 
Byte 2: 


Match with DCBDSORG 
Reserved 


Message area 
Address of the user-supplied password 


Address of the user exit list 


DD name 


Offset to the TIOT 
Indicator flags 
Access method type 
Error flags 


Address of the DEB 
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ACB—Access Method Control Block 


Bytes and 
Offset Bit Pattern 
Not Changed by OPEN 
48 (30) 1 
1. 
Tees 
1. 
al 
XXes aXe 
49 (31) 1 
50 (32) 2 
me 
ale 
1... 
a 
1. 
re | 
Kec 
51 (33) 1 
52 (34) 4 
56 (38) 4 
60 (3C) 2 
62 (3E) 2 
64 (40) 4 
68 (44) 4 
72 (48) 4 


Field Name 


ACBOFLGS 


ACBEOV 
ACBOPEN 
ACBDSERR 


ACBEXFG 
ACBLOCK 
ACBIOSFG 


ACBBUSY 


ACBERFLG 


ACBINFLG 


ACBJEPS 
ACBIJRQE 
ACBCAT 
ACBSCRA 


ACBUCRA 
ACBVVIC 


ACBBYPSS 


ACBUJFCB 
ACBBUFSP 


ACBBLKSZ 
ACBMSGLN 


ACBLRECL 
ACBUAPTR 


ACBCBMWA 


ACBAPID 


Description 


Open/Close flags: 


EOV concatenation 

The ACB is open 

No further requests are possible against 
the ACB 

An ACB Exit routine exists 

The ACB is locked 

The Open or Close routine 

is in control 

The ACB is busy 

Reserved 


Error flags 

Note: See “Diagnostic Aids: Open, Close, 
and End-of-Volume Error Codes’’ for details 
on the ACBERFLG error flags. 


Indicator flags: 


JEPS processing 

RQE being held by JAM 

The ACB describes a VSAM catalog 
Catalog recovery area is built in system 
storage 

Catalog recovery area is built in user storage 
Data set being opened is the mass storage 
volume inventory (MSVI data set) 

Bypass security checking on Open if user is 
authorized 

Reserved 


Reserved 
Address of the user JFCB 
Amount of space available for the buffers 


Length of the physical DASD record 
Message length 


Length of the user’s record 
Address of the user’s work area 
Address of the CBM work area 
Address of application ID 
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AMB—Access Method Block 


The AMB describes a VSAM data set or index and points to control blocks 


needed to process data set and index records, such as the BUFC, the PLH, 
the catalog’s ACB, and the AMDSB. An AMB is built for a cluster’s data set 


J 


and, if the cluster is key-sequenced, an AMB is built for the index. Each 
AMB associated with the cluster is pointed to by the AMBL (AMBLDTA 
points to the data AMB; AMBLIX points to the index AMB). When a data 
set’s or index’s record is being processed by VSAM record management, 
register 3 (RAMB) points to the data set’s or index’s AMB. 


Offset 


0 (0) 
1 (1) 
2 (2) 
4 (4) 
8 (8) 


12 (C) 
16 (10) 


20 (14) 
24 (18) 


25 (19) 


26 (1A) 
26 (1A) 
27 (1B) 


28 (1C) 
32 (20) 
35 (23) 


Bytes and 
Bit Pattern 
1 
1 


2 
4 
4 


2 
1 
1. 


XXXK .XXX 
4 
3 
3 


Field Name 


AMBID 
AMBRSC 
AMBLEN 
AMBLINK 
AMBBUFC 


AMBPH 
AMBCACB 


AMBDSB 
AMBEOVR 


AMBFLG1 
AMBCREAT 


AMBTYPE 


AMBMCAT 


AMBUCAT 
AMBSPEED 


AMBUBF 


AMBJRN 


AMBINBUF 


AMBDSORG 


AMBIOBAD 
AMBCDSN 
AMBDDSN 


Description 


Control block identifier, X‘40’ 
Resource test and set byte 

Length of the AMB 

Address of the next AMB in the chain 


Address of the BUFC associated with the 
AMB 


Address of the PLH associated with the AMB 


Address of the VSAM catalog’s ACB (the 
ACB of the catalog that contains the object’s 
catalog record) 


Address of the AMDSB 
End of volume request type: 


Mount by key 
Mount by RBA 
Allocate by key 
Allocate by RBA 


Indicator flags: 


The object is being created 

The AMB describes a data set 

The AMB describes the index of a 
key-sequenced data set 

The AMB describes the VSAM master 
catalog 

The AMB describes a VSAM user catalog 
Speed option: Control intervals are not 
preformatted before the user’s data records 
are written (only applies when the data 

set is created). 

The user’s EXLST contains a buffer handling 
exit routine’s address 

The user’s EXLST contains a journaling exit 
routine’s address 

The data set is shared—a direct buffer 
request has been issued 


Data set organization indicators: 
Reserved 


VSAM access method 
Reserved 


Address of the IOB 
Data set name of the VSAM catalog 


Data set name of the object associated with 
the AMB 
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Access Method Block (AMB)—Description and Format 


Offset 

38 (26) 
40 (28) 
42 (2A) 
42 (2A) 


43 (2B) 
44 (2C) 
44 (2C) 
45 (2D) 
48 (30) 


49 (31) 


50 (32) 
52 (34) 
56 (38) 


60 (3C) 
64 (40) 
68 (44) 
72 (48) 


76 (4C) 
80 (50) 
84 (54) 
84 (54) 


85 (55) 
86 (56) 


88 (58) 


Bytes and 


Bit Pattern 


XXX. ... 


XXX 


2 
2 
1 


- ff Sf FF 


Field Name 


AMBTIOT 
AMBINFL 
AMBCAT 
AMBSCRA 


AMBUCRA 
AMBUPX 


AMBAMETH 
AMBDEBPT 


AMBDEBAD 
AMBOFLGS 


AMBOPEN 
AMBEXFG 
AMBBUSY 


AMBFLG2 
AMBPUG 


AMBRPT 
AMBEDB 
AMBEOVPT 


AMBWKA 
AMBIWA 
AMBIOBA 
AMBIXP 


AMBPAMBL 
AMBUPLH 
AMBCSWD1 
AMBAFLG 


AMBLSR 
AMBICI 
AMBDFR 
AMBSIS 
AMBCFX 


AMBRDCNT 


AMBBM2SH 


Description 


. Reserved 


Address of the TIOT 
Indicator flags: 


The AMB describes a VSAM catalog’s 
data set or index 

Catalog recovery area is in system storage 
Catalog recovery area is in user's storage 
An upgrade table (UPT) exists 

Reserved 


VSAM access method indicator 
Address of the DEB and error flags: 
Error flags 

Address of the DEB 

Open status flags: 


The AMB is open 

User exit routines are active 
Busy bit 

Reserved 


Flag byte 2: 


The data set described by this AMB 
is an alternate index in an upgrade set 
Reserved 


Address of the EDB 


Address of the key or RBA to be used by the 
VSAM End of Volume routine 


Address of the AMB work area 
Address of the DIWA 
Address of the IOB 


Address of the index’s AMB if this is a data 
AMB for a key-sequenced data set. 


Address of the primary AMBL 
Address of upgrade placeholder 


Flat byte: 


Local shared resources 

Improved control-interval access 
Defer write operations 

Sequential insert strategy 

Control blocks fixed in real storage 
Reserved 


Reserved 


Number of control intervals read for this 
AMB 


Address of PLH doing second search of 
subpool 
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Access Method Block (AMB)—Description and Format 


Offset 
92 (5C) 


96 (60) 

100 (64) 
108 (6C) 
110 (6E) 
112 (70) 
114 (72) 
116 (74) 


AMBL—Access Method Block List 


Bytes and 
Bit Pattern 


4 


ha N N N WN CO Ff 


Field Name 
AMBCPA 


AMBWSHD 
AMBEXEX 
AMBSZRD 
AMBSZWR 
AMBSZFW 
AMBSZCP 


Description 


With shared resources: address of the 
WSHD);; without shared resources: address of 
the first CPA in the chain 


Address of working storage header 

Name of user’s exception exit routine 

Size of the channel program for read 

Size of the channel program for write 

Size of the channel program for format write 
Size of the CPA base 


Reserved 


The AMBL describes a VSAM cluster and points to the cluster’s data set and 
index AMBs. When the cluster is opened, an AMBL is built to describe the 
cluster. If the cluster’s data set (and index) is shared with other users, AMBs 
already exist for the data set (and index). The existing AMB’s addresses are 
put into the AMBL. If the cluster is not shared, AMBs are built to describe 
the cluster’s data set and, if the cluster is key-sequenced, to describe the data 
set’s index. The AMBL is pointed to by the cluster’s ACB (ACBAMBL). 


Offset 


0 (0) 


4 (4) 


8 (8) 


12 (C) 


12 (C) 


13 (D) 
14 (D) 
16 (10) 
16 (10) 
16 (10) 
20 (14) 


oe XX 


Bytes and 
Bit Pattern 


4 


XXXX 


Ww ht 0c Cc WN =— 


Field Name 


AMBLPCHN 


AMBLSCHN 


AMBLACB 


AMBLEOV 


AMBLEFLG 


AMBLWAIT 
AMBLESET 


AMBLCOMP 


AMBLDDNM 
AMBLIDF 
AMBLCACB 
AMBLDCI 


Description 
Address of the primary AMBL in the AMBL 
chain 


Address of the secondary AMBL in the 
AMBL chain 


Address of the ACB associated with the 
AMBL 


Work area for End of Volume and Record 
Management routines 


End of Volume flags: 


End of volume is waiting 

End of Volume encountered an error and 
restored control blocks to their original 
condition 

Reserved 


End of Volume lock 

Reserved 

The ACB’s DDNAME field 
Cluster identifier: 

Address of the ACB of the catalog 


Control-interval number of the catalog data 
record 
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Access Method Block List (AMBL)—Description and Format 


Bytes and 
Offset Bit Pattern 
23 (17) 1 
1... 
al 
ae | 
Res 
1. 
wl. 
Pe. Ae 
24 (18) 4 
28 (1C) 2 
28 (1C) 1 
29 (1D) 1 
30 (1E) 1 
| ee 
.1.. 
Pell 
| ae 
~XXX 
31 (AF) 1 
32 (20) 1 
33 (21) 1 
| 
he 
7 
ooeX XXXX 
34 (22) 1 


Field Name 


AMBLQ 


AMBLDDC 
AMBLLSR 
AMBLFSTP 


AMBLUBF 
AMBLKSDS 
AMBLESDS 


AMBLDFR 


AMBLXPT 


AMBLVC 


AMBLVRT 


AMBLENO 
AMBLTYPE 


AMBLPATH 
AMBLUPGR 
AMBLAIX 
AMBLBASE 
AMBLFIX 


AMBLID 
AMBLSHAR 


AMBLPRIM 
AMBLCATO 
AMBLWRIT 


AMBLLEN 


Description 
Qualifier: 


DD connect only 

Cluster opened for local shared resources 
Cluster opened for fast path (improved 
control-interval access) 

Cluster opened for user buffering 

Cluster opened as a key-sequenced data set 
Cluster opened as an entry-sequenced data 
set 

Cluster opened for deferred writes 
Reserved 


In a base AMBL, address of the path AMBL; 
in a path AMBL, address of the base AMBL 


Identifies the entry in the valid-AMBL table 
that identifies this AMBL: 


Number of the valid-AMBL table in the 
chain of valid-AMBL tables 


Offset within the valid-AMBL table 
Type of control block structure opened: 


Path 

Upgrade set 

Alternate index 

Base cluster 

Control blocks are fixed in real storage 
Reserved 


Reserved 


Control block identifier, X*°50’ 
Sharing indicators: 


Identifies the primary AMBL 

The catalog is open 

The user intends to write or update records 
in the data set 

Reserved 


Length of the AMBL 
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Access Method Block List (AMBL)—Description and Format 


Offset 
35 (23) 


36 (24) 


37 (25) 
38 (26) 
40 (28) 
41 (29) 
42 (2A) 


52 (34) 
56 (38) 


60 (3C) 
64 (40) 


Bytes and 
Bit Pattern 


1 


ook = «=OXLX, 


XXXX 


BN 


Field Name 


AMBLFLG1 
AMBLFULL 


AMBLCINV 


AMBLUPD 


AMBLVVIC 


AMBLSCRA 


AMBLUCRA 


AMBLCAT 


AMBLDUMY 


AMBLFLG2 


AMBLREST 
AMBLCKPT 
AMBLRST1 

AMBLSTAG 


AMBLNST 
AMBLNUM 


AMBLNIDS 
AMBLMIDS 


AMBLDTA 
AMBLIX 


AMBLBIB 
AMBLCMB 


Description 
Flags: 


The user-supplied master password was 
verified 

The user-supplied control interval 
password was verified 

The user-supplied update password was 
verified 

The AMBL is for the mass storage volume 
inventory (MSVI) data set 

The AMBL is for a catalog recovery area in 
system storage 

The AMBL is for a catalog recovery area in 
user's storage 

The AMBLACB field points to a catalog’s 
ACB 

A DD DUMMY statement was specified 
The combination of these bits indicates the 
type of data set: 


001 Catalog 
101 MSVI 
011 SCRA 
Flags: 


A Restart routine is in control 

A Checkpoint routine is in control 
Update the high RBA for Restart 
The cluster is staged 

Reserved 


Number of strings 

Number of AMB pointers in the AMBL 
Reserved 

Number of identifiers 


Five 2-byte fields, each containing a V3AM 
module’s identifier | 


Address of the cluster’s data set AMB 
Address of the key-sequenced cluster’s index 
AMB 

Address of the base information block 


Address of the cluster management block 
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AMCBS—Access Method Control Block Structure Block 


The AMCBS contains information that is used by OS/VS to locate the master 
catalog and user catalogs. The AMCBS is completed when the master catalog 
is opened. IDA019C1, a VSAM module in located in the pageable nucleus, 
contains the AMCBS at entry point IDA019C2. The CVT (CVTCBSP) 


points to the AMCBS. 
Bytes and 

Offset Bit Pattern 
0 (0) 2 

2 (2) 2 

4 (4) 4 

8 (8) 4 

12 (C) 4 

16 (10) 4 

20 (14) 4 

24 (18) 4 

28 (1C) 4 

32 (20) 8 


Field Name 


CBSID 
CBSSIZ 


CBSACB 
CBSCBP 


CBSCMP 


CBSCAXCN 
CBSCRACA 
CBSCRTCB 
CBSVSRT 


CBSVUSE 
CBSVPTR 


AMDSB—Access Method Data Set Statistics Block 


The AMDSB contains statistical information about record processing in the 
data set. It also contains some of the data set’s attributes and specifications. 
The AMDSB is built, using the data set or index catalog record’s AMDSB set 
of fields, when the cluster is opened. The data or index AMB (AMBDSB) 
points to its associated AMDSB. 


Offset 


0 (0) 
1 (1) 


2 (2) 
4 (4) 


6 (6) 


Bytes and 
Bit Pattern 


Field Name 


AMDSBID 
AMDATTR 
AMDDST 


AMDWCK 
AMDSDT 


AMDREPL 
AMDORDER 


AMDRANGE 
AMDRRDS 
AMDSPAN 


AMDLEN 
AMDNEST 
AMDAXRKP 
AMDRKP 


Description 


AMCEBS ID character 

Length of the AMCBS 

Reserved 

Address of the VSAM master catalog’s ACB 


Address of the control block manipulation 
routine 


Address of the catalog management 
high-level routine (IGGOCLAI1) 


Address of the CAXWA chain 
Address of the CRA CAXWA chain 
Address of CRA task TCB 


CDS (compare and swap double) word for 
VSRT (VSAM shared resource table) 


VSRT use count 
Address of the VSRT 


Description 


AMDSSB identifier, X‘60’ 
Attributes of the data set: 


Key-sequenced data set 

Entry-sequenced data set 

Check each record when it is written 
Sequence set is stored with the data and is 
replicated. 

All index records are replicated—duplicated 
around the track. 

Use the volumes in the same order as in the 
volume list 

The data set is divided into key ranges. 
Relative record data set 

The data set contains spanned records 


Length of the AMDSB 
Number of index entries in the index section 
Relative key position of the alternate key 


Relative key position 
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Fen 


Access Method Data Set Statistics Block (AMDSB)—Description and Format 


Offset 
8 (8) 
10 (A) 


11 (B) 


12 (C) 
14 (E) 


16 (10) 
20 (14) 
24 (18) 
28 (1C) 


32 (20) 


36 (24) 
40 (28) 
40(28) 


41 (29) 
48 (30) 
56 (38) 
58 (3A) 
60 (3C) 


64 (40) 
68 (44) 
72 (48) 
76 (4C) 
80 (50) 


Bytes and 
Bit Pattern 


2 
1 


No 


> 2 Ff 


Field Name 


AMDKEYLN 
AMDPCTCA 


AMDPCTCI 


AMDCIPCA 
AMDFSCA 


AMDEFSCI 
AMDCINV 
AMDLRECL 
AMDHLRBA 


AMDNSLOT 
AMDSSRBA 


AMDMAXRR 


AMDPARDB 
AMDSTAT 
AMDATTR3 
AMDUNQ 


AMDFAULT 


AMDBIND 


AMDWAIT 


AMDLM 


AMDSTSP 
AMDNIL 
AMDNEXT 
AMDNLR 


AMDDELR 
AMDIREC 
AMDUPR 
AMDRETR 
AMDASPA 


Description ) 
Key length 


Percentage of free control intervals in the 
control area 


Percentage of free bytes in the control 
interval 


Number of control intervals in a control area 


Number of free control intervals in a control 
area 


Number of free bytes in a control interval 
Control interval size 
Maximum record size 


Relative byte address (RBA) of the high-level 
index record 


Number of record slots per control interval 


Relative byte address (RBA) of the first 
sequence-set record 


Maximum valid relative record number 


Address of the first ARDB 
Data set statistics: 
Attributes of the data set: 


The data set has: 

Q Unique keys 

1 Nonunique keys 

The data set is staged: 

QO At open time, if required 

1 By cylinder fault 

The data set is: 

Q Not bound 

1 Staged and bound 

After destaging is begun, control is returned 
to the program that is closing the data set: 
QO Immediately 

1 After destaging is finished 

Q Load mode, or data set is not loaded 
1 Data set is loaded 

Reserved 


Reserved 

OS/VS system timestamp 
Number of index levels 

Number of extents in the data set 


Number of user-supplied records in the data 
set 


Number of deleted records 
Number of inserted records 
Number of updated records 
Number of retrieved records 


Number of bytes of free space in the data set 
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Access Method Data Set Statistics Block (AMDSB)—Description and Format 


Bytes and 
Offset Bit Pattern 
84 (54) 4 
88 (58) 4 
92 (SC) 4 


ARDB—Address Range Definition Block 


Field Name 
AMDNCIS 
AMDNCAS 
AMDEXCP 


Description 


Number of times a control interval was split 
Number of times a control area was split 


Number of times EXCP was issued by VSAM 
I/O routines 


The ARDB contains information about space allocated to and space actually 
used by a data set. The block is built by the VSAM Open routine from 
information in the data set’s catalog record. The ARDB is updated by record 
management routines as additional space is used. The first ARDB in an 
ARDB chain is pointed to by the AMDSB (AMDPARDB). 


Bytes and 
Offset Bit Pattern 
0 (0) 1 
1 (1) 1 
1 (1) Lissa 
ails 
Eee bs 
| Be 
5 
X ..XX 
2 (2) 
4 (4) 4 
8 (8) 
12 (C) 4 
16 (10) 4 
20 (14) 6 
26 (1A) 2 
28 (1C) 1 
| oe 
Ass 
.XX XXXX 


Field Name 


ARDID 
ARDTYPE 


ARDKR 
ARDHLI 


ARDSS 


ARDEOD 


ARDUSED 


ARDLEN 
ARDNPTR 
ARDHKRBA 


ARDHRBA 


ARDERBA 


ARDVOLSR 


ARDRELNO 


ARDPRF 


ARDPRSS 
ARDPRFMT 


Description 


Control block identifier, X°61’ 


Identifies the type of space defined by the 
ARDB: 


One key range of a key-range data set 

The total index of a key-sequenced data set, 
or 

The non-sequence set levels of a 
key-sequenced data set’s index, 

when the sequence set is stored 

with the data 

The sequence set of a key-sequenced data set, 
when the sequence set is stored with the data 
The key range containing the highest 

data RBA in the data set 

The ARDHRBA field’s initial value 

has changed 

Reserved 


Length of the ARDB 
Address of the next ARDB chain 


The RBA of the data set control interval 
containing the key range’s high-key value 


The RBA of the next free-space control 
interval at the end of the data set 


The RBA of the highest control interval 
allocated to the key range 


The serial number of the volume containing 
the highest RBA allocated to the key range 


The sequence number of the Data Space 

Group set of fields that describes the data 
space containing the key range. The Data 
Space Group set of fields is in the volume 
catalog record identified by ARDVOLSR. 


Preformat flags: 


The sequence set is stored with the data 
The key range’s extents haven't been 
preformatted 

Reserved 
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Address Range Definition Block (ARDB) Description and Format 


Bytes and 
Offset Bit Pattern Field Name Description 
29 (1D) VL ARDKEYS The key range’s low and high key values. J 
The length of this field equals twice the key 
length. 


BIB—Base Information Block 


The BIB contains information for Virtual-Storage Management to control 
allocation of storage for a particular base cluster in a job step. It is further 
described in ‘‘Virtual-Storage Management” in ‘‘Diagnostic Aids.”’ 


The BIB is pointed to by the AMBL (AMBLBIB). 


Bytes and 
Offset Bit Pattern Field Name Description 
0(0) 4 BIBHDR Header: 
0(0) 1 BIBID Control block identifier, X‘10 
1 (1) 1 BIBFLGI1 Flag byte 1: 
| eer BIBVIRT At least one mass-storage UCB is allocated 
.XXX XXXX Reserved 
2 (2) 2 BIBLEN Length of the BIB 
4 (4) | BIBFLG2 Reserved 
5 (5) 3 Reserved 
8 (8) 4 BIBUPT Address of the upgrade table 
12 (C) 4 BIBVMT Address of the volume mount table 
16 (10) 4 BIBDACB Address of an inner (“dummy”) ACB J 
20 (14) 4 BIBAMBL Address of the primary AMBL in the AMBL 
chain 
24 (18) 4 BIBSPHPT Address of the sphere block 
28 (1C) 4 BIBPRSPH Address of the protected sphere block 
32 (20) 4 BIBHEBPT Address of the header element block 
36 (24) 4 BIBHEBFQ Address of the first free header element in 
the header element block 
40 (28) 4 BIBVCRT Address of the VSAM checkpoint/restart 
table 
44 (2C) 4 BIBWSHD Address of the working storage header 
48 (30) 16 BIBRTNS Addresses of Record-Management routines: 
48 (30) 4 BIBINTRF VSAM interface (IDA019R1) 
52 (34) 4 BIBCEAPP Channel end appendage 
56 (38) 4 BIBASYRT Asynchronous Routine 
60 (3C) 4 BIBSIOAP Start-I/O appendage 
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BLPRM—Resource Pool Parameter List 


BLPRM is created by the BLDVRP and DLVRP macros. It is used by Record 
Management for dynamic string additiona dn by data set management for 
internal processing. BLPRM is mapped by IDABLPRM and pointed to by the 
parameter list whose address is in register 1 when SVC 19 is issued. 


Resource Pool Parameter List (BLPRM)—Description and Format 


Offset 
0 (0) 
1 (1) 
2 (2) 
4 (4) 


8 (8) 
9 (9) 
10 (A) 


11 (B) 


12 (C) 
13 (D) 
16 (10) 
16 (10) 


17 (11) 
20 (14) 
21 (15) 
24 (18) 
24 (18) 
27 (1B) 


Bytes and 


Bit Patterns 


oe XX 


1 


1 
2 
4 


Field Name 
BLPACBID 
BLPACBST 


BLPBUFLP 


BLPUACB 


BULPIOPLH 


BLPKEYLN 
BLPSTRNO 
BLPFLAGI1 


BLPFDBDC 
BLPFBLD 
BLPFDEL 
BLPFLSR 
BLPFGSR 
BLPFIOBF 
BLPFBFRF 
BLPFSTAD 


BLPFLAG2 


BLPFPART 
BLPFUPGR 
BLPFPATH 
BLPFPRIM 
BLPFDATA 
BLPFINDX 
BLPFIOSR 
BLPFRSTR 


BLPOCODE 
BLPOACB 
BLPCORE 
BLPGFLG 


BLPGREQ 
BLPGPG 


BLPGSZ 
BLPGSP 
BLPGAD 
BLPIOACB 


BLPDSORG 


Description 
ACBID—X°* AO’ 
ACB subtype—X‘11’ 
Reserved 


Address of the buffer list used by BLDVRP 
(described below) 


Address of the user ACB (used for dynamic 
string addition) 


Address of the I/O Support PLH (used for 
CLOSE) 


Key length 
String number requests 
Flag byte 1: 


Shared resources 
BLDVRP request 
DLVRP request 
LSR option 

GSR option 

Fix IOBs 

Fix buffers 

Add String 


Flag byte 2 (used for I/O support internal 
processing): 


Partial build request 
Upgrade set Open 
Path (AIX) Open 
Primary Open 

Data AMB 

Index AMB 

I/O support request 
Restart request 


Special use field 

Address of ACB 

Record management GETCORE request 
Flag byte: 


GETCORE request 
GETCORE page boundary request 
Reserved 


GETCORE length 
GETCORE subpool 
GETCORE return address 
Address of I/O support ACB 
Reserved 


X‘08’ (required for BLDVRP,DLVRP, and 
string addition) 
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Resource Pool Parameter List (BLPRM)—Description and Format 


Offset Bit Patterns Field Name 


Bytes and 
28 (1C) 20 
48 (30) | 
49 (31) 2 
51 (33) | 


BLPOFLGS 


BLPERFLG 


Description 


Reserved 
X‘02’ 
Reserved 


X‘00’ 


The buffer request list (pointed to by BLPBUFLP) is repeated once for each buffer 


pool. The format is: 


0 (0) 4 

4 (4) | 
-XXX XXXX 

5 (5) 1 

6 (6) 2 


BLPBUFSZ 
BLPBRLFG 
BLPBFLST 


BLPBFLCT 


Buffer size 
Buffer list flags: 


Last buffer request 
Reserved 


Reserved 


Buffer count 
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BSPH—Buffer Subpool Header 


The BSPH is built for processing with shared resources. It defines a buffer 
pool in the VSAM resource pool. The first BSPH for the resource pool is 
pointed to by the VSRT (VSRTBUFH). Each BSPH is pointed to by an AMB 
(AMBBUFC) that uses the buffer pool defined by the BSPH. 


Offset 
0 (0) 
1 (1) 


2 (2) 
4 (4) 
8 (8) 


12 (C) 
14 (E) 
16 (10) 


20 (14) 


24 (18) 


28 (1C) 


28 (1C) 


29 (1D) 
30 (1E) 
32 (20) 


36 (24) 


40 (28) 


44 (2C) 


48 (30) 


52 (34) 


56 (38) 
60 (3C) 


Bytes and 
Bit Pattern 


N WN 


.1.. @eee 
XX XXXX 


1 


Field Name 
BSPHID 
BSPHFLG! 
BSPHIOBF 
BSPHBFRF 
BSPHLEN 
BSPHNM 
BSPHNBSP 


BSPHBFNO 
BSPHERCT 
BSPHBUFC 


BSPHMDBT 


BSPHBSZ 


BSPHCSRC 


BSPHFLG2 


BSPHAPRT 
BSPHPCUC 


BSPHPSUC 
BSPHCPLH 


BSPHRDS 


BSPHFND 


BSPHUIW 


BSPHNUIW 


BSPHUTOP 


BSPHUBTM 
BSPHIST 


Description 
Control block identifier, X°72’ 
Flag byte 1: 


I/O-related control blocks are fixed in real 
storage 

I/O buffers are fixed in real storage 
Length of the BSPH 


Visual name: ‘BSPH’ 


Address of the next BSPH for the resource 
pool 


Number of buffers in the buffer pool 
Count of write errors 


Address of the first BUFC for the buffers in 
the pool 


Modification bits—they indicate IDs of 
transactions that have modified the buffer 
(RPL TRANSID operand) 


Length of each buffer in the pool 


Compare/Swap resource—used to serialize 
the use chain: 


Flag byte 2: 


Arithmetic protect bit 
The use chain is being changed 
Reserved 


Reserved 
Number of PLHs searching the use chain 


Address of the PLH that is modifying the 
use chain 


Number of I/O operations to bring data into 
the buffer pool 


Number of requests for retrieval that could 
be satisfied without an I/O operation 


Number of user-initiated writes from the 
buffer pool 


Number of non-user-initiated writes (writes 
that VSAM was forced to do because no 
buffers were available) 


Address of the top of the use chain 
Address of the bottom of the use chain 


Address of the first BSPH for the resource 
pool 


Data Areas 561 


BUFC—Buffer Control Block 


The BUFC consists of a buffer header (that describes the buffer pool) and a 
buffer control entry (that describes each buffer requested by the user and 
each buffer required for preformat processing). The header describes the 
structure of the buffer pool. Each buffer control entry contains function 
codes, status indicators, and RBAs to describe the buffer. The buffer control 
entry also contains the address of its associated placeholder (PLH), the data 
buffer, the associated channel program (pointed to by the CPA), and the next 
BUFC in the chain. The BUFC is the interface between the I/O Manager 
routine (IDA019R3) and the Buffer Manager routines (IDA019R2 and its 
procedures). The BUFC is pointed to by the PLH (PLHBUFC points to the 
data BUFC; PLHIBUFC points to the index BUFC). 


The buffer header and the buffer control entries are created by Open and 
released by Close. The AMB points to the buffer header. The DIWA points 
to the insert buffer control entry, and each placeholder points to a chain of 
one or more data buffer control entries and one index buffer control entry. 


Bytes and 
Offset Bit Pattern 
Buffer Header 
0(0) | 
1(1) | 
2 (2) 
4 (4) 4 
8 (8) | 
9 (9) | 
10 (A) | 
11 (B) 1 
ie 
wL.. 
..XX XXXX 
12 (C) 4 
16 (10) 4 
Buffer Control Entry 
0 (0) 1 
0 (0) | 


Field Name 


BUFDRID 
BUFDRNO 


BUFDRLEN 
BUFDRPFB 


BUFDRPFN 
BUFDRCIX 


BUFDRMAX 


BUFDRTSB 


BUFDRFLG 


BUFDRREL 


BUFDRAVL 


BUFDBUFC 


BUFCAVL 
BUFCUCNT 


Description 


Buffer-header identifier, X*70’. 


Number of buffer control entries in this 
buffer pool, excluding preformat buffer 
control entries. 


Length of the BUFC entry 


Pointer to the first BUFC in a pool of BUFCs 
that are reserved for preformatting data 
control areas or index tracks. 


Number of preformat BUFCs. 


Number of index buffers in an index buffer 
pool that are not assigned to a placeholder 
and are not reserved for the highest level 
index record. 


Maximum number of buffers that can be 
assigned to a placeholder that is in sequential 
mode. 


Test-and-set byte for the buffer header. This 
byte is set to X*FF’ when a buffer is being 
taken from the buffer pool and assigned to a 
placeholder; set to X‘00’ in all other cases. 


Buffer status flags: 


Buffer-released flag, which is set when a 
placeholder returns a buffer to the buffer 
pool. 

Buffer is available, which is set when there 
are data buffers in the pool that are not 
reserved for inserts and are not assigned to 
placeholders. 

Reserved 


Address of the first BUFC 


Reserved 


Test-and-set byte for the buffer. 


Use count 
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J 


Buffer Control Block (BUFC)—Description and Format 


Bytes and 
Offset Bit Pattern 
1 (1) 1 
Liss 
ale 
a 
1... 
js 
sels 
re | 
2 (2) 1 
1... 
Be 
ee 
ee 
i Boe 
ra Ges 
wl 
cuux 
3 (3) 1 
aos be 
XX.. XXXX 
4 (4) 4 
8 (8) 4 
12 (C) 4 
16 (10) 4 
20 (14) 4 
24 (18) 4 


Field Name 


BUFFLGI1 


BUFCUPG 
BUFCSEG 


BUFCINS 
BUFCERI1 
BUFCER2 


BUFCVAL 
BUFCEXC 


BUFCEPT 


BUFCIOFL 
BUFCMW 


BUFCFMT 


BUFCRRD 


BUFCREAL 
BUFCWC 


BUFCXEDB 


BUFCPFCP 


BUFCFIX 
BUFCFLG2 
BUFCBSYR 


BUFCBSYW 


BUFCPLH 


BUFCAMB 


BUFCDD 


BUFCORBA 


BUFCCPA 


BUFCBAD 


BUFCNXT1 


Description 
BUFC status flags: 


This BUFC is associated with an upgrade set 
The buffer contains a segment of a spanned 
record 

Identifies this buffer as an insert buffer. This 
buffer can be assigned to a placeholder for 
data only for the duration of a single request. 
Error generated by input processing. 

Error generated by output processing. 

Input RBA is valid. 

The control interval represented by this 
BUFC is in exclusive control. This field is 
meaningful only when the input RBA is 
valid. 

I/O-complete flag. 


I/O status flags: 

Control interval must be written at the 
indicated output RBA (BUFCORBA). Note 
that output processing is done before input 
processing for the same BUFC. 

This BUFC is associated with a format-write 
channel program. 

The control interval indicated by 
BUFCDDDD must be read. 

Reserved. 

The channel program associated with this 
BUFC includes write-validity-checking 
CCWs. 

The RBA that was to be read or written was 
in an extent of the data set that was 
unavailable (for example, not mounted). 


Preformatted channel-program segment is 
complete. 
Reserved. 


Flag byte 2: 


For processing with shared resources, a read 

operation is in progress—the bit is on during 
the operation 

For processing with shared resources, a write 
operation is in progress—the bit is on during 
the operation 

Reserved 


Address of the placeholder associated with 
this BUFC. 

Address of the access method block 
associated with this BUFC 


RBA for input processing (valid only if bit in 
FLGI is set). 


RBA for output processing (valid only if 
IOFL indicates that a control interval must 
be written). 


Channel program area address. 


Address to or from which control interval is 
to be written or read. 


Next BUFC for which I/O can be requested. 
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Buffer Control Block (BUFC)—Description and Format 


Bytes and 

Offset Bit Pattern Field Name Description 

28(1C) 8 Reserved 

36(24) 1 BUFCIDXL For processing without shared resources, the 
level of the index record in the buffer—used 
in the selection of the buffer to be replaced 

37 (25) 3 BUFCNXT2 Address of the next logical buffer 

40 (28) 4 BUFXIRBA RBA of the record in the buffer or, fora 
spanned record, of the record’s first segment 

44 (2C) 4 BUFXORBA Same as BUFXIRBA, but used for output 

48 (30) 4 BUFCHAIN Address of the next BUFC in the pool 

52 (34) 4 BUFCMDBT For shared resources, modification 
bits—they identify IDs of transactions that 
have modified the buffer (RPL TRANSID 
operand) 

56 (38) 4 BUFCUCUP Address of the next BUFC up the use chain 

60 (3C) 4 BUFCUCDN Address of the next BUFC down the use 
chain 


CAXWA—Catalog Auxiliary Work Area 


The CAXWA is built when a VSAM master or user catalog is opened or is 
being created. The CAXWA contains the addresses of control blocks and 
work areas needed when a catalog is being opened or created, such as the 
alternate TIOT, the DRWA, and the UCB. The CAXWA also contains flags 
that indicate the type of processing being performed on the catalog and the 
OS/VS component that invoked the processing. The CAXWA is pointed to 
by the ACB (ACBUAPTR). The AMCBS (CBSCAXCN) contains the 
address of the CAXWA chain. 


Bytes and 
Offset Bit Pattern Field Name Description 
0 (0) 1 CAXID Control block identifier, X°CA’ 
1 (1) 3 Reserved 
4 (4) 4 CAXCHN Address of the next CAXWA in the chain 
8 (8) 1 CAXFLGS Flags: 
Wises: dae CAXBLD Build request 
emer CAXOPN The catalog is being opened 
ele, tee CAXCLS The catalog is being closed 
Gerke ales CAXEOV An End of Volume routine is in control 
1... CAXCMP Open/Close/EOV processing is complete 
my Ie CAXMCT Identifies the VSAM master catalog 
.O.. Identifies a VSAM user catalog 
ne le CAXCMR Catalog management (SVC 26) has been 
called by a catalog management routine 
rr | CAXSCR Catalog Management (SVC 26) has been 
called by the OS/VS Scheduler 
..00 Catalog management (SVC 26) has been 
called by an Access Method Services 
procedure 
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Catalog Auxiliary Work Area (CAXWA)—Description and Format 


Offset 
9 (9) 


10 (A) 


11 (B) 

12 (C) 

16 (10) 
20 (14) 
24 (18) 
28 (1C) 
32 (20) 
32 (20) 


35 (23) 


38 (26) 
41 (29) 


44 (2C) 
46 (2E) 


48 (30) 


52 (34) 
52 (34) 
58 (3A) 
62 (3D) 
66 (42) 
74 (4A) 


Bytes and 
Bit Pattern 


MX .. 


1 


on ape ank 


Field Name 


CAXFLG2 
CAXF2DT 


CAXF2NDD 
CAXF2NCR 


CAXF21OE 
CAXF2CLR 
CAXF2CA 
CAXF2REC 
CAXF2VTU 


CAXFLG3 


CAXF3AT 
CAXF3ANE 
CAXF3B5 


CAXF3B6 


CAXACT 
CAXATIOT 
CAXSCHWA 
CAXDRWP 
CAXACB 
CAXUCB 
CAXCCR 
CAXHACI 


CAXNFCI 


CAXCDCI 
CAXFDCI 


CAXRPLCT 


CAXRPL 


CAXCNAM 
CAXVOLID 
CAXRACTS 
CAXRATEP 
CAXRADDN 


Description 
Flags: 


The catalog has been deleted 

The following flags are set by IFG0191X 
and IFGO0200N: 

No DDNAME found 

Unable to obtain virtual storage with a 
GETMAIN request 

1/O error 

RPL cleanup request 

If an error occurs, free the CAXWA 
Recoverable catalog 

Volume timestamp updated 


Flags: 


CRA alternate TIOT exists 
CRA does not exist 

Password not read 

No passwords 

Master password; no update 
password 

Master and update passwords 
Reserved 


Catalog activity count 

Address of the alternate TIOT 
Address of the Scheduler work area 
Address of the catalog’s DRWA 
Address of the catalog’s ACB 
Address of the UCB 

Catalog control record information 


Control interval number of the highest 
allocated control interval in the catalog 


Control interval number of the next free 
control interval in the catalog 


Number of deleted control intervals 


Control interval number of the first deleted 


control interval in the catalog 
Reserved 


Number of RPLs associated with the 
CAXWA 


Address of the first RPL in the CAXWA’s 
RPL chain 


Catalog’s dsname 

CRA volume serial 

CRA creation timestamp 
CRA’s TIOT entry address 
CRA’s DDNAME 
Reserved for CRA 
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Catalog Auxiliary Work Area (CAXWA)—Description and Format 


Bytes and 
Offset Bit Pattern Field Name Description 
96 (60) 4 CAXOPLST Open/Close parameter list: 
96 (60) 1 COPTS Option flags: 
| Comer CENLST End of list indicator 
-XXX XXXX Reserved 
97 (61) 3 COPACB Address of the catalog’s ACB 
100 (64) 4 CAXOPEWA Address of the Open/Close/End of Volume 
work area 
104 (68) 4 CAXCCA Address of the CCA 
108 (6C) CAXJDE Address of the JDE 
112 (70) CAXCRACB Address of the CRA’s ACB 


CCA—Catalog Communications Area 


The CCA is built each time an OS/VS component issues the CATLG macro 
instruction (SVC 26) to process a catalog record. The CCA contains 
information about the catalog being processed, and about the catalog record 
and its extensions contained in each of the six buffers available to process the 
user’s request. The CCA is used to pass information between catalog 
management procedures. Register 11 contains the address of the CCA. 


Bytes and 
Offset Bit Pattern Field Name Description 
0 (0) 2, CCAID Identifier, X‘ACCA’ 
2 (2) 2 CCASZ Length of CCA 
4 (4) 4 CCAPROB Problem determination: 
4 (4) 2 CCAMODID Error module ID 
6 (6) 2 CCAERRCD Error code 
6 (6) 1 CCAREASN Set reason code 
6 (6) 1 CCACDR Refer reason code 
7 (7) 1 CCARETRN Set return code 
7 (7) 1 CCACD1 Refer return code 
8 (8) 5 Reserved 
13 (D) 1 CCACD2 Return code 2 


Note: See “Diagnostic Aids: Catalog 
Management Error Codes’’ for a list of the 
VSAM Catalog Management return codes 
and error codes. 
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Catalog Communications Area (CCA)—Description and Format 


Bytes and 
Offset Bit Patten Field Name Description 
14 (E) 1 CCAFLG1 Flags Byte 1: 
Wicoeee Teees CCAFILPS Stop the loop 
Mie dks Reserved 
dale axes CCAFILRD Catalog control record read 
into virtual storage 
ma I Heeag CCAFIKEY Retrieve the catalog record based on 
a DSNAME value 
Liss CCAFIKGE Retrieve the next catalog record 
alsa CCAFICR A checkpoint of the catalog control 
record is required 
eel CCAF1UP GET for update 
ae CCAFIDK When the caller is renaming a data set, this 
flag indicates that the data set’s true name 
record is to be deleted, but the data set’s 
catalog record is not to be deleted. 
15 (F) | CCAFLG2 Flags Byte 2: 
Tee sede CCAF2SYS The caller is an OS/VS system module 
eli. Aaes CCAF2NVC No validity check on the caller’s CTGFL or 
work area is required 
scien et CCAF2CCT Search all catalogs available to the caller. 
She -eeise Search the first VSAM catalog specified by 
the caller’s STEPCAT statement. 
If the caller's JCL doesn’t include 
a STEPCAT statement, search the 
VSAM master catalog. In either case 
search only one catalog. 
er CCAF2XEQ Exclusive enqueue 
BO) Wotas Shared enqueue 
Vea CCAF2RHS When a catalog management routine 
calls the VSAM Open routines to open 
a newly created catalog, and the Open 
routines call VSAM Catalog Management 
routines to obtain information about the 
catalog to be opened, the situation is called 
a “‘recursive call.’’ The catalog cannot be 
dequeued when the Catalog Management 
routines return to the caller (VSAM Open 
routines). 
XX. CCAF2COB Both catalog open and build: 
IPs CCAF2CO Catalog is being opened 
wel CCAF2CB Catalog is being created 
wal CCAF2SMO Search the master catalog only 
16 (10) 1 CCAFLG3 Flags Byte 3: 
| Serre CCAEXGRI1 Exit indicator 
allot. wets CCAGC4 The catalog record contains a password 
information set of fields, identified by Type 
Code 4 (detected during IGGPSCNC 
processing) 
is ere CCAGDSP Caller specified the GENDSP option 
(detected during IGGPSCNC processing) 
ral meres CCAEXGR2 Exit indicator 
Lina CCANF The set of fields cannot be found 
a CCAELC2 Exit indicator 
ole CCALFT First time 
a | CCAEGREC Exit indicator 
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Catalog Communications Area (CCA)—Description and Format 


Offset 
17 (11) 


18 (12) 


19 (13) 


20 (14) 
20 (14) 
24 (18) 
24 (18) 
28 (1C) 
32 (20) 
36 (24) 


Bytes and 
Bit Pattern 


1 


ha bh fbf Lh fF Hh A 


Field Name 
CCAFLG4 
CCAF4DRQ 


CCAF4BYS 
CCAGVNC 


CCAGVNF 


CCAGVNBS 


CCAGVEX 
CCAGVNE 


CCATCOMP 


CCAFLG5 


CCAMEX2 
CCAMEX 
CCAMEX1 
CCAMODPA 


CCATHIT 


CCATEX 
CCATEX!1 
CCATEX2 


CCAFLG6 
CCAMCODR 


CCADELP 
CCAMNOSP 


CCAINIT 
CCASUPFD 


CCAREUSE 


CCAEXT 


CCAMOD 


CCATCB 
CCALBCYL 
CCARB 
CCADPL 
CCACPL 
CCAACB 
CCANPCCB 


Description 
Flags Byte 4: 


The catalog must be dequeued after the 
request completes 

Bypass the security verification 

The required variable-length field is not 
completely contained in the record 
currently in the buffer 

The set of fields identified by the 
caller-specified sequence number cannot 
be found 

There is no buffer space available to 
contain an extension record 

Exit indicator 

The field does not exist in the located 
set of fields 

Test complete: all set-of-fields pointers 
have been examined and all designated 
fields have been tested 


Flags Byte 5: 


Exit indicator 

Exit indicator 

Exit indicator 

The catalog record’s base record must be 
written (using IGGPPAD) into the catalog 
Successful test: a set of fields has been 
found that satisfies the test conditions 
Exit indicator 

Exit indicator 

Exit indicator 


Flags Byte 6: 


The catalog must be dequeued when the 
request completes 

A deleted set-of-fields pointer was found 
The catalog record’s free space isn’t large 
enough to contain all the new catalog 
information during the set-of-fields move 
operation 

Insert switch for variable-length field 

being retrieved 

Suppress password field information during 
field retrieval 

The contents of the caller’s record areas 
(buffers) can be used by IGGPEXT and 
IGGPMOD 

Set when a catalog management routine calls 
the Extract routine (IGGPEXT) 

Set when a catalog management routine calls 
the Modify routine (IGGPMOD) 


Address of the TCB 

Address of label cylinder data 
Address of the RB 

Address of DADSM parameter list 
Address of the caller’s CTGPL 
Address of the catalog’s ACB 
Address of the next PCCB 
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Catalog Communications Area (CCA)—Description and Format 


Offset 
40 (28) 


44 (2C) 


44 (2C) 


47 (2F) 
88 (58) 


88 (58) 


89 (59) 
90 (SA) 
92 (SC) 
96 (60) 


100 (64) 


104 (68) 


108 (6C) 


128 (80) 


148 (94) 


168 (A8) 


188 (BC) 


208 (DO) 


Bytes and 
Bit Pattern 


4 


44 


41 
20 


Field Name 
CCAURAB 


CCASRCH 


CCASRID 
CCASRCIN 


CCARABO 


CCARxFLG 


CCARxUR 


CCARxU1 


CCARxU2 
CCARxWR 


CCARXxPA 


CCARxUPD 
CCARORPL 


CCARxREC 
CCARxSEG: 
CCACPE2x 


CCACPE3x 
CCACPE4x 


CCARABI 


CCARAB2 


CCARAB3 


CCARB4 


CCARABS5 


CCARPLK 


Description 


Address of the record area block (RAB) 
currently in use 


Search argument (dsname of a cluster, 
data set, index, catalog, or nonVSAM data 
set, or a volume serial number) 


Control interval number 


Reserved 


Record Area Block: 0: Each record area 
block describes the catalog record contained 
in one of the six catalog management buffers 
available for the request. RAB’s 1 through 5 
are identical in format to RAB 0. 


Note: ‘x’ in each field name is replaced by ‘0’ 
through ‘S’ to indicate a particular RAB’s 
field. 


Flags: 


The following flag is used by IGGPEXT and 
IGGPMOD: 

The RAB is in use. It cannot be used by 
IGGPEXT or IGGPMOD 

The RAB is temporarily in use by IGGPEXT 
or IGGPMOD. It cannot be overlaid. 

(Same as CCARxU]1) 

The buffer must be written before another 
catalog record can be read into it 

The buffer contains a new catalog 
record—PUT-add is required to write the 
record into the catalog 

Reserved 

The buffer contains a GET-for-update record 


Last assigned RPL index 
Reserved 
Address of the record in the buffer 


Addresses of parts of the catalog record: 
Address of the first byte after tha fixed-length 
header fields. 


Address of the first set of fields 


Address of the first free-space byte in the 
record 


Record Area Block 1 (See RAB 0 
description) 


Record Area Block 2 (See RAB 0 
description) 


Record Area Block 3 (See RAB 0 
description) 


Record Area Block 4 (See RAB 0 
description) 


Record Area Block 5 (see RAB 0 
description) 


Work area for IGGOCLAG and IGGOCLAM 
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Catalog Communications Area (CCA)—Description and Format 


Offset 
209 (D1) 
210 (D2) 
211 (D3) 
212 (D4) 
218 (DA) 
220 (DC) 
224 (EO) 


224 (EO) 
225 (E1) 
226 (E2) 


228 (E4) 
228 (E4) 


230 (E6) 
230 (E6) 
232 (E8) 
234 (EA) 
268 (10C) 


269 (10D) 
270 (10E) 


271 (10F) 
280 (118) 
280 (118) 
281 (119) 
282 (11A) 


283 (11B) 
284 (11C) 
288 (120) 
292 (124) 
296 (128) 
300 (12C) 
300 (12C) 
304 (130) 
308 (134) 


Bytes and 


Bit Pattern 


Ean o 


Nn N NY fF 


1... 
O... 
-XXX XXXX 


1 


- + fb fF 


4 
1 


Field Name 


CCARPLF 
CCARPLX 
CCARPLT 
CCARPLAA 


CCARPLI 
CCADESA. 


CCANDEXT 
CCAIXEXT 
CCASSVOL 


CCAEXTDE 
CCAEXTSS 


CCAEXTAD 
CCAEXTCC 
CCAEXTHH 
CCAEXTTH 
CCAASCIK 


CCACRRP 
CCAASCIX 


CCAASCI 
CCAEQDQ 
CCAEDXFF 
CCAEDRLN 
CCAEDOPT 
CCAEDSHR 


CCAEDRCD 
CCADEQNM 
CCAEDRNM 
CCAEDUCB 
CCAMLRET 
CCAMSSPL 
CCAMNLEN 
CCAMNPTR 


Description 


(Same as CCARPLK) 
(Same as CCARPLK) 
(Same as CCARPLK) 
Indexes to assigned RPLs 
Reserved 

Address of the RPL in use 


Save area for the extent information 
returned by OS/VS DADSM and VSAM 
Catalog Management: Suballocate 


Number of extents 
Extent index value 


Sequence number of the data set directory 
entry in the volume catalog record 


Five 8-byte extent descriptors: 


Sequence number of the Data Space Group 
set of fields that this extent’s space is a part 
of. 


The extent’s starting physical address: 
Cylinder number CC 

Head number HH 

Number of tracks in the extent 


Number of control intervals required to 
satisfy the caller’s request 


RPL used to read the CCR 


Used by the ASSIGN functions—points to 
the element in CCAASCI currently being 
processed 


Number of each assigned control interval 
ENQ/DEQ parameter list: 

‘End of parameter list’’ indicator—X‘FF’ 
Length of minor name 

ENQ/DEQ options 


Shared 
Exclusive 
Reserved 


ENQ/DEQ return code 
Address of the major name 
Address of the minor name 
Address of the UCB 

Address of the caller’s save area 
Storage management work area: 
Number of bytes to process 
Address of the return address 


Reserved 
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Catalog Communications Area (CCA)—Description and Format 


Offset 

309 (135) 
310 (136) 
312 (138) 
316 (13C) 
316 (13C) 


320 (140) 


Bytes and 
Bit Pattern 


1 


2 
4 
8 
4 


> 


Field Name 


CCAMNSPL 


CCARPRM 
CCACMS 


CCACMSWA 


CCAEXCMS 


Description 


Required subpool number 

Reserved 

Return parameters 

Catalog Management Services work area: 


Address of the catalog management services 
calling routine’s work area 


Address of a secondary catalog management 
services work area 


The following fields are set and used by IGGPLOC, IGGPEXT, IGGPMOD, and 
IGGPTSTS, and catalog management subfunctions that these procedures call: 


324 (144) 


328 (148) 
332 (14C) 
336 (150) 
340 (154) 
344 (158) 
348 (15C) 


352 (160) 
356 (164) 
358 (166) 
360 (168) 
364 (16C) 


368 (170) 
372 (174) 


376 (178) 


380 (17C) 


384 (180) 


388 (184) 


392 (188) 


395 (18B) 
396 (18C) 


398 (18E) 


> 


&_ f NY NY Ff 


CCACPE5 
CCALUME 


CCACPES1 
CCACPES2 
CCACPES53 
CCACPE6 

CCACPE6!1 


CCACPE7 
CCAIDPT 


CCACPE71 


CCAGOPLN 


CCASL 
CCAILNG 


CCAFLPT 
CCATFLPT 


CCARABPT 
CCADICT 


CCAXCPL 
CCAMCPL 


CCARABB 


CCARABF 


CCARABL 


CCACBASE 


CCAGC 


CCALREL 
CCALRELI 


CCASN 
CCASNI1 


Address of a selected set of fields 
pointer 


(Same as CCACPES) 
(Same as CCACPES) 
(Same as CCACPES) 
Address of a selected set of fields 
(Same as CCACPE6) 


Address of a selected retrieved field 
(Same as CCACPE7) 


(Same as CCACPE7) 

Length of the set-of-fields pointer 
Number of bytes for the sequence number 
Length of the selected retrieved field 


Address of the requested-field CTGFL 
Address of the CTGFL-for-tests 


Address of the record area block 


Dictionary information to describe the field, 
based on its field name 


Address of the CTGPL built when 
IGGPEXT and IGGPMOD are called, so 
that information in the caller’s CTGPL is not 
altered 


Address of the RAB that identifies the base 
catalog record 


Address of the RAB that identifies the first 
record area (buffer) that can be used by 
IGGPEXT or IGGPMOD 


Address of the RAB that identifies the last 
record area (buffer) that can be used by 
IGGPEXT or IGGPMOD 


The control interval number of the base 
catalog record 


Type code of the requested set of fields 


Relative repetition number of a selected 
set of fields 


Sequence number of a selected set of fields 
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Catalog Communications Area (CCA)—Description and Format 


Bytes and 

Offset Bit Pattern Field Name Description 

400 (190) 2 Reserved J 

402 (192) Z CCAIXFPL Index to the current CTGFL being processed 

404 (194) 2 CCAIXREL Index for CCATREL 

406 (196) 2 CCATNREL The sequence number of the next set of fields 
to perform tests against if CCATREL is full 
or if there are no buffers available to contain 
the catalog record’s next extension 

408 (198) 2 CCATNUM Number of successful relative repetition 
numbers (cannot exceed 16) 

410 (19A) 32 CCATREL Successful relative repetition numbers 

442 (1BA) 2 CCATNO Total number of successful relative repetition 
numbers (might exceed 16) 

444 (1BC) 4 CCATEST Address of the test CTGFL 

448 (1CO) 20 CCARBA Work area for extent descriptors: 

448 (1C0) 6 CCACRAVL CRA volume serial number 

448 (1C0) 2 CCASS Sequence number of the Data Space Group 
set of fields that contains the extent 

450 (1C2) 4 CCACCHHI1 Physical address—CCHH—of the extent’s 
first track 

454 (1C6) 4 CCACRADT CRA device type 

454 (1C6) 4 CCACCHH2 Physical address—CCHH—of the extent’s 
last track 

458 (1CA) 2 CCATT Number of tracks in the extent ; 

460 (1CC) 4 CCARBAI Low relative byte address (RBA) ao 

464 (1D0) 4 CCARBA2 High relative byte address (RBA) 

468 (1D4) 2 CCATLNG The total length of the extent information 
that has been processed 

CCATLEN Total length of the scanned field so far 

470 (1D6) 2 CCARBAL RBA extent balance 

472 (1D8) 2 CCACNIX Combination name index 

474 (IDA) 2 CCASMFIX The type of SMF record to be written when a 
cluster or catalog is defined (SMF record for 
the cluster, data set, or index) 

476 (1DC) 4 CCAIDPT2 Address of the available space in the caller’s 
work area or of the caller-supplied update 
information 

480 (1E0) 4 CCAIDPT3 Address of the length field of a 
variable-length field in the user’s return area 

484 (1E4) 2 CCAGVCT Number of set-of-fields pointers processed so 
far 

486 (1E6) 2 CCANEVV If the requested variable-length field is 
non-existant, this field is set to binary zero 

488 (1E8) 3 CCAGVEXT Control interval number of the record’s next 
extension record (not yet in a buffer) 

491 (1EB) | CCANEFV If the requested fixed-length field is 


nonexistant,existant, this byte is set to X°FF’ 


492 (IEC) 1 Reserved ) 
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Catalog Communications Area (CCA)—Description and Format 


Offset 


493 (IED) 
493 (IED) 
494 (1EE) 


494 (1EE) 
496 (1F0) 
498 (1F2) 


500 (1F4) 


502 (1F6) 


504 (1F8) 


506 (1FA) 


509 (1FD) 
512 (200) 
516 (204) 
520 (208)) 
522 (20A) 
524 (20C) 
528 (210) 


532 (214) 
536 (218) 
540 (21C) 
544 (220) 
548 (224) 


552 (228) 


553 (229) 


Bytes and 
Bit Pattern 


1 
1 
2 


& fF N NY Ff LF W 


—_, 


1 


Field Name 


CCAGRGC 
CCARCDID 


CCAGRHI 
CCAGRHIt 


CCASSEQ 
CCAIXTPL 
CCADLEN 


CCADIFF 


CCAREPCT 


CCADISP 


CCASVCI 


CCASVCI1 
CCADTA 
CCACDTA 
CCADTCT 
CCACDTCT 
CCACWAP 


CCAMNADR 


CCAILNG3 
CCAILNG2 
CCAALPTR 
CCASMFPT 
CCALCPL 


CCAFLG7 
CCALSP 


CCASMFEX 
CCASMFA 


CCASMFBR 


CCAONCE 
CCAROREQ 
CCAFEOV 
CCACRABU 


CCAFLG8 
CCADSRCL 


CCAVBUFI 


CCASCRA 


Description 
Group code of the requested set of fields 
Record ID 


Sequence number of the requested 
set of fields 


Save sequence number 
Index to test CTGPLs 


Number of bytes to be deleted from the 
catalog record 


The difference between the insert length and 
the delete length (can be a negative number) 


Number of relative repetition numbers 
processed so far 


Displacement into variable-length field to 
the delete/insert location 


Save area for the control interval number of 
the base catalog record 


Save area for the control interval number 
Address of the dictionary 

Address of the index combination table 
Number of dictionary entries 

Number of index combination entries 
Address of the controller work area 


Address of the virtual storage obtained by a 
GETMAIN request 


Save area for the insertion length 

Length of the user-supplied insert data 
Address of the space management work area 
Address of the SMF record chain 


Address of the CTGPL used when a catalog 
management routine issues the LSPACE 
macro instruction 


Flag byte 7: 


LSPACE has been called by a catalog 
management routine 

SMF exit indicator 

Perform SMF alter processing during 
IGGPEXT and IGGPMOD processing 
The base catalog record is in a record 
area (buffer) for SMF processing 
Move only one set of fields 
Request-type is read-only 

Force end of volume request 

A CRA is being built 

Flag byte 8: 

Recursive call for DEFINE 

space 

Number of volume records 


buffered 
Suppress CRA updates 
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Catalog Communications Area (CCA)—Description and Format 


Bytes and 
Offset Bit Pattern 


| 


554 (22A) 


555 (22B) 
556 (22C) 
560 (230) 


562 (232) 


1 


Field Name 
CCASCICK 
CCALPIND 
CCAVRIND 
CCALEOD 
CCAAUCAT 


CCAFLG9 


CCARABYC 
CCARAEOV 
CCARALRD 
CCARACR 
CCAUCRA 


CCARAACT 
CCARAICI 
CCARESUM 


CCANORBA 
CCASMFRD 
CCASMFCT 


CCASMFLG 
CCASMFG1 


Description 


Suppress CRA control interval 
check 

Loop control in buffer scan 
for GETs 

Volume record buffer chain 

is to be checked 

End-of-file on low keys 
Volume has a user catalog 


Flags byte 9: 


Bypass catalog I/O 

CRA end-of-volume 

CRA CCR has been read 

CRA CCR checkpoint requested 
Use CRA CI number translate table 
before CRA GET 

CRA is active 

Inhibit catalog I/O 

Replace sum 

Increment sum 


Number of RBAs needed 
Address of the SMF record 


Number of catalog records in the SMF record 
chain to be used in creating the SMF ALTER 
record 


SMF record flags: 


Before calling the SMF-record-writing routine, the caller sets these bits to indicate what 
it has done or intends to do: 


Lis 


XX 
563 (233) 
564 (234) 


566 (236) 
569 (239) 
572 (23C) 
575 (23F) 
578 (242) 


580 (244) 


584 (248) 


588 (24C) 


592 (250) 


Ny WY WwW Ww W 


CCASMFUC 
CCASMFDF 
CCASMFSR 


CCASMFAL 


CCASMFG2 
CCASMFLN 


CCACHAIN 
CCACI1 
CCACI2 
CCACT3 
CCAVARLN 


CCARRAB 


CCARBASE 


CCAVARPT 


CCADELN 


Uncatalog—write SMF record type 67 
DEFINE—write SMF record type 63 

Data set, index, or nonVSAM data set has 
been scratched—write SMF record type 67 
ALTER—vwrite SMF record type 63 
Reserved 


Reserved 


Amount of virtual storage obtained for the 
SMF record 


Control interval number save area 
Control interval number save area 
(Same as CCACI1) 
(Same as CCACI1) 


Number of bytes to be inserted into the 
record 


Address of the RAB containing the 
set-of-fields pointers where delete/insert 
processing is to begin. 


(Same as CCARRAB) 


Address of the information to be inserted 
into the record 


Number of bytes to be deleted from the 
record 


574 OS/VS2 SVS Independent Component: Virtual Storage Access Method (VSAM) Logic 


J 


Catalog Communications Area (CCA)—Description and Format 


Offset 


594 (252) 
614 (266) 
634 (27A) 


637 (27D) 


640 (280) 
680 (2A8) 
684 (2AC) 


684 (2AC) 
686 (2AE) 
688 (2BO) 
690 (2B2) 


691 (2B3) 
692 (2B4) 


692 (2B4) 
694 (2B6) 
696 (2B8) 


697 (2B9) 
699 (2BB) 
700 (2BC) 
704 (2CO0) 
708 (2C4) 


712 (2C8) 

714 (2CA) 
716 (2CC) 
718 (2CE) 
720 (2D0) 
724 (2D4) 
728 (2D8) 
732 (2DC) 
736 (2E0) 


XXX 


Bytes and 
Bit Pattern 


20 
20 
3 


BAN 


NY N WN 


wok 


Field Name 


CCAVAR 
CCAVARI 
CCADEL! 


CCADEL2 


CCAXLATE 
CCARI4S 
CCABMxxx 


CCABMTRK 
CCABMLIM 
CCABMMIN 
CCABMFLG 


CCABMST 
CCABMCHK 
CCABMSET 
CCABMCCK 
CCABMLST 


CCABMOUT 


CCABMONN 
CCABMOTR 
CCABMOFG 
CCABMOST 


CCABMPAD 
CCABMGOP 
CCABMPTR 

CCABMEND 


CCABMBT1!1 
CCABMBTL 
CCABMBYT 
CCABMSTR 
CCABMWK1 
CCABMWK2 
CCADMWK3 
CCABMWK4 
CCABMRB! 


Description 


Insert information save area 
(Same as CCAVAR) 


The control interval number of the first 
record in a series of records to be deleted 


The control interval number of the last 
record in a series of records to be deleted 


Temporary compiler work area 
IGGOCLC®9 Register 14 save area 


Bit manipulation routine (IGGOCLBR) work 
area 


Starting track number 

Ending track number, or upper limit 
Minimum number of tracks required 
State and function code: 


State to set or condition to check 
Perform the check 

Set the state 

Perform a conditional check 
Last set required 

Reserved 


Reserved 


Output parameters for the bit manipulation 
routine (IGGOCLBR) 


Number of tracks 
Starting track number 
Output flags: 


State of bits 
Reserved 


Reserved 

Padding character 

Address of the current space map set of fields 
Address of the current bit mask byte 


Address of the end of the current space map 
set of fields 


Number of bits—first byte 
Number of bits—last byte 
Number of full bytes 

Current bit mask starting track 
Work area 

Work area 

Work area 

Work area 


Address of the first RAB that points to the 
space map set of fields 
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Catalog Communications Area (CCA)—Description and Format 


Offset 
740 (2E4) 


744 (2E8) 
784 (310) 


784 (310) 
788 (314) 
1132 (46C) 
1132 (46C) 
1136 (470) 
1140 (474) 


1144 (478) 
1145 (479) 


1148 (47C) 
1152 (480) 
1156 (484) 
1160 (488) 
1164 (48C) 
1168 (490) 
1168 (490) 


1170 (492) 
1172 (494) 


1173 (495) 
1176 (498) 
1180 (49C) 


1188 (4A4) 


1196 (4AC) 
1204 (4B4) 


1208 (4B8) 
1208 (4B8) 
1210 (4BA) 
1211 (4BB) 


Bytes and 
Bit Pattern 


- & Fk Fk OO F 


Nv bf fF fF FL SH FS 


» XX 


_ WwW 


Field Name 
CCABMRB2 


CCATEMPS 
CCAREGS 


CCAMODNM 
CCABZSAV 
CCADSPWA 


CCACUMPL 


CCASBASE 


CCACRACI 

CCARAACB 
CCARARPL 
CCARARBA 
CCARAREC 
CCARALSA 
CCACRABT 


CCAFLG10 


CCAINCPL 
CCAPDMW 
CCACATAC 
CCARAFEV 
CCARARTC 
CCAPRANX 


CCASUMTT 
CCADICTS 
CCAPANCA 


CCARAVCA 


CCAVTS 
CCAREWKA 


CCASMFP 
CCASMFMD 
CCASMFRC 
CCASMFCD 


Description 


Address of the second RAB that points to the 
space map set of fields 


Compiler “TEMPS” work area 


Register 12, 13, and 14 save area 
(See ‘“‘Diagnostic Aids” for details about the 
CCA register save area) 


Address of user save area 

Load module name 

Address of the save area for IGGOCLBZ 
Address of DEFINE SPACE work area 
Reserved 


Address of the catalog management upgrade 
parameter list 


Reserved 


Save base control interval for upgrade 
process 


Address of the CRA record pointer array 
Address of the CRA’s ACB 

Address of the CRA RPL 

Relative byte address of the CRA 
Address of a CRA record 

Address of the CRA local save area 


Block/track value for CRA record 
construction 


Reserved 
Flag byte 10: 


Catalog parameter list is invalid 
Problem determination message 
Catalog is active 

Forced end of volume 

Recovery exit - return to caller 
Prime CRA gone 

Reserved 


Sum of the tracks in the CRA 
Data/index timestamp 


Start, end addresses of normal record buffer 
chain 


Start, end addresses of volume record buffer 
chain 


Volume timestamp 


Address of reusable data set processing 
workarea 


Save area for SMF problem determination 
Module ID 
Reason code 


Return code 
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Catalog Communications Area (CCA)—Description and Format 


Bytes and 
Offset Bit Pattern 
1212 (4BC) 4 
1212 (4BC) 2 
1214 (4BE) 2 
1214 (4BE) | 
1215 (4BF) | 


CLW—Close Work Area 


Field Name 


CCAPROBX 
CCAMODDX 
CCAERCDX 
CCARESNX 
CCARETRX 


Description 

Save area for CCAPROB 
Error module ID 

Error codes 

Reason code 


Return code 


The CLW contains information used for communication among the Close and 
temporary Close modules. It is built by IDAQ200T (CLOSE) and IDA0231T 
(CLOSE,TYPE=T), mapped by IDACLWRK, and pointed to by register 4 
during VSAM Close processing. 


CLOSE Work Area (CLW)—Description and Format 


Bytes and 
Offset Bit Pattern 
0 (0) 4 
4 (4) 4 
8 (8) 12 
20 (14) 2 
Byte 1: 
| eee 
A 
al. 
| Pee 
i 
wl. 
re | 
Byte 2 
Lak: kes 
ales 
wile 
XXXX 


CMB—Cluster Management Block 


Field Name 
CLWCOMWK 
CLWAMBPT 
CLWSFI 
CLWFLAGS 


CLWBNOFL 
CLWCNOUP 
CLWNWRIT 
CLWPATH 
CLWSPHCL 
CLWDUMMY 
CLWOUTPT 
CLWPARCL 


CLWPRMCL 
CLWSECCL 
CLWGMAIN 
CLWTERM 


Description 


Address of common work area 


Address of current AMB 


Subfunction information area 


Flag bytes: 


No buffer flush 

No catalog update 
No write buffer 
Path processing 
Close entire sphere 
Dummy data set 


Base data set opened for output 


Partial close 


Primary close 
Secondary close 
Module work area built 


Terminating error in IDA0200B 


Reserved 


The CMB contains the addresses of header elements in the header element 


block that describe storage obtained for the control blocks of a 


key-sequenced or entry-sequenced data set. 


The CMB is pointed to by the AMBL (AMBLCMB). It is further described 
in “Virtual-Storage Management” in “Diagnostic Aids.” 


Offset 
0 (0) 
1 (1) 
2 (2) 


Bytes and 
Bit Pattern 


I 
1 
2 


Field Name 
CMBID 


CMBLEN 


Description 


Control block identifier, X‘11’ 


Reserved 
Length of the CMB 
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Cluster Management Block (CMB)—Description and Format 


Offset 
4 (4) 


5 (5) 


6 (6) 
8 (8) 


8 (8) 
12 (C) 
16 (10) 
20 (14) 
24 (18) 
28 (1C) 
32 (20) 
36 (24) 
40 (28) 
44 (2C) 


CPA—Channel Program Area 


Bytes and 


Bit Pattern 


-XXX XXXX 


1 


- fh ff fF HL FL FH Hh LH A 


Field Name 


CMBFLGS 
CMBOUT 


CMBNST 


CMBCNT 
CMBPTRS 


CMBUSRPT 
CMBPRPTR 
CMBSTPTR 
CMBUSPTR 
CMBFSTPT 

CMBUFSPT 
CMBBFRPT 
CMBUBFPT 
CMBDEBPT 
CMBEDBPT 


Description 


Flags: 

The control block structure allows output 
requests 

Reserved 


Number of strings set up in the control block 
structure 


Number of addresses that follow: 


Addresses of header elements in the header 
element block. 


User block header 

Protected user block header 

String block header 

Upgrade string block header 

Fixed string block header 

Fixed upgrade string block header 

Buffer block header 

Upgrade buffer block header 

DEB (data extent block) block header 
EDB (extent definition block) block header 


The CPA contains addresses to CCW chains that perform specialized I/O 
processing. The CPA also contains information needed to convert the 
addresses of virtual storage data areas to real main storage addresses for the 
channel. Each BUFC has a CPA associated with it, pointed to by the 
BUFCCPA. 


Note: See module listing IDA019R3 for channel program building and 
execution details. The formats of four channel programs follow this 


description of the CPA. 

Bytes and 
Offset Bit Pattern Field Name 
0 (0) 1 CPAID 
1 (1) 1 
2 (2) CPALEN 
4 (4) 4 CPAWREAL 
8 (8) 4 CPAWCPS 
12 (C) 4 CPAWCPE 
16 (10) 4 CPAWCKS 
20 (14) 4 CPAWCKE 
24 (18) 4 CPARREAL 
28 (1C) 4 CPARCPS 


Description 


Control block identifier, X‘71’ 
Reserved 
Length of the CPA 


Real address of the previous write channel 
program segment 


Real address of the first CCW in the write 
channel program segment 


Real address of the last CCW in the write 
channel program segment 


Real address of the first CCW in the write 
check channel program segment 


Real address of the last CCW in the write 
check channel program segment 


Real address of the previous read program 
channel segment 


Real address of the first CCW in the read 
channel program segment 
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Channel Program Area (CPA)—Description and Format 


Offset 


32 (20) 


36 (24) 


36 (24) 
37 (25) 
37 (25) 
39 (27) 
43 (2B) 
44 (2C) 


48 (30) 


52 (34) 


52 (34) 
53 (35) 
53 (35) 
55 (37) 
59 (3B) 
60 (3C) 


64 (40) 
68 (44) 
72 (48) 
76 (4C) 


80 (50) 


82 (52) 
83 (53) 


84 (54) 
84 (54) 


Bytes and 
Bit Patten 


4 


- -—- ff N AH 


> &}&+ ft F 


-XXX XXXX 


2 


Byte 1 


Field Name 
CPARCPE 


CPAWPHAD 


CPAWSEEK 
CPAWBB 
CPAWCHR 


CPAWSID 


CPAFWCNT 


CPARPHAD 


CPARSEEK 
CPARBB 
CPARCHR 


CPAIDAL 


CPAVPL 
CPAWORK 1! 
CPAWORK2 
CPABLKSZ 


CPABCINV 


CPASSECT 
CPASTAT1 
CPAVPLV 


CPAFLAGS 
CPAFLAG1 


CPAWV 
CPAWCV 


CPARV 


CPAWRPS 


CPARRPS 


CPACHNED 


Description 


Real address of the last CCW in the read 
channel program segment 


The physical address for records to be 
written, in the form MBBCCHHR: 


Reserved (M value) 

Seek address: 

BB value 

Cylinder and head address (CCHH value) 
Reserved (record number R) 


Address of the search argument list for write 
channel program segments 


Address of the count fields list for the format 
write channel program segment 


The physical address for records to be read, 
in the form MBBCCHHR: 


Reserved (M value) 

Seek address: 

BB value 

Cylinder and head address (CCHH value) 
Reserved (record number R) 


Address of the real page list (indirect data 
address list) 


Address of the virtual page list 
Work area 
Work area 


The physical blocksize value calculated by 
the I/O Manager: Convert routine 


Number of physical blocks per control 
interval 


Set sector argument 
Flags: 


The virtual page list (VPL) is valid 
Reserved 


Flags: 


The write channel program segment is valid 
The write check channel program segment 
is valid 

The read channel program segment is valid 
The write channel program segment 
(preceeded by a set sector CCW) is 

valid 

The read channel program segment 
(preceeded by a set sector (CCW) is 

valid 

Chaining of the channel program segments 
is complete 

Reserved 
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Channel Program Area (CPA)—Description and Format 


Bytes and 
Offset Bit Pattern Field Name Description 
85(55) Byte 2 CPAFLAG2 J 
ce tapes CPAWREPL The write channel program segment 
is used to write replicated index 
records 
ee CPARREPL The read channel program segment is used to 
read replicated index records 
oe CPAXLRA There has been a LRA instruction error 
ail eas CPAPFENT The pagefix appendage has been called 
as CPATKOFL Track:overflow 
sess oXXX Reserved 
86 (56) 1 CPARSECT Set sector argument—read 
87 (57) 1 CPAWSECT Set sector argument—write 
88 (58) CPANXTI Address of the static CPA chain 
92 (SC) CPACPCHN Address of the dynamic CPA chain 
Channel Programs 
Four channel programs (read, format write, update write, and write check) 
are used for I/O operations: 
Read Channel Program 
The read channel program is used to retrieve data from direct-access storage. 
CCW Command Code Flags 
Number Hex Description Address Hex Description Count 
R1 1B Seek head CPARSEEK 40 CC 6 ; 
R2 231 Set sector CPARSECT 60 CC, SLI 1 
R3 31 Search IDeq. CPARSID 60 CC, SLI 5 
R4 08 TIC R3 
R52 063 Read data IDAL 40 CC 
CPABLKSZ 
864 M-T read data IDAL 40 CC 
CPABLKSZ 
Ra 035 No op 20 SLI 2 


1 Unless there is RPS (Rotational Position Sensing), R2 is a no op. 


2 RS is repeated for each physical record per control interval that is retrieved. 


3 R5 uses a read-data command for the first physical record. 


4R5 usesa multiple-track read-data command for subsequent physical records. 


5 Rn can be changed to a TIC (transfer in channel) command to chain to another 


read channel program. 
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Format Write Channel Program 


Update Write Channel Program 


The format write channel program is used to preformat or write data on a 
whole track (as in loading a data set with the SPEED option). 


CCW Command Code 


Number Hex 


FW! 1B 
FW2 231 
FW3 31 

FW4 08 

FW52 1D 
FW62 1D 
CPABLKSZ 
FWn 033 


1 Unless there is RPS (Rotational Position Sensing), FW2 is a no op. 
2 FW5 and FW6 are repeated (write count, key, and data) for each physical record 


on a track. 


Description 
Seek head 
Set sector 
Search ID eq. 
TIC 


Address 
CPAWSEEK 
CPAWSECT 
CPAWSID 
FW3 


Write C,K,&D CPAFWCNT 
Write C,K,&D IDAL 


No op 


Flags 
Hex 


40 
60 
40 


80 
44 


20 


3 FWn can be changed to a TIC (transfer in channel) command to chain to 
another format write channel program or to a write check channel program. 


Description Count 
CC 6 

CC, SLI l 

CC 5 

CC 8 

CC, IDAL 

SLI 2 


The update write channel program is used to write data on a part of a track 


(as in insertion). 
CCW Command Code 


Number Hex 


UwWwI1 1B 
Uw2! 23 
Uw32 = 31 
UW#2 08 
UWS2 = 05 
CPABLKSZ 
UWn 033 


1 Unless there is RPS (Rotational Position Sensing), UW2 is a no op. 


Description 
Seek head 
Set sector 
Search ID eq. 
TIC 

Write data 


No op 


Address 
CPAWSEEK 
CPAWSECT 
CPAWSID 
UW3 

IDAL 


Hex 


20 


2 UW3, UW4, and UWS are repeated for each physical record indicated in the 


CPA. The command code for subsequent UW3s is B1, multiple-track search ID 


equal. 


3 UWn can be changed to a TIC (transfer in channel) command to chain to 
another update write channel program or to a write check channel program. 


Description Count 
CC 6 

CC, SLI 1 

CC 5 

CC, IDAL 

SLI 2 
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Write Check Channel Program 


The write check channel program is used to retrieve data to compare it with 
the data that was previously written. 


CCW Command Code Flags 
Number Hex Description Address Hex Description Count 
WCl 1B Seek head CPAWSEEK 40 CC 6 
WC2 231 Set sector CPAWSECT 60 CC, SLI 1 
WC3 31 Search IDeq. CPAFWCTN2 40 CC 5 
CPAWSID3 

WC4 08 TIC WC3 
WCS5 064 Read data IDAL 50 CC, Skip 
CPABLKSZ 

86° M-T read data IDAL 50 CC, Skip 
CPABLKSZ 
WCn 036 No op 20 SLI 2 


1 Unless there is RPS (Rotational Position Sensing), WC2 is a no op. 

2 CPAFWCNT is used to check a format write. 

3 CPAWSID is used to check an update write. 

4 WCS uses a read-data command for the first physical record. 

5 WC5 uses a multiple-track read-data command for subsequent physical records. 


© WCn can be changed to a TIC (transfer in channel) command to chain to 
another write check channel program. 
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CSL—Core Save List 


The CSL contains up to 32 entries that describe virtual-storage areas acquired 
by GETMAIN in Open. It enables Open to free these areas if it detects an 
error that prevents them from being freed in normal Open termination. 


The CSL is pointed to by OPWA (called the ACB work area). Additional 
CSLs are chained as required. 


Bytes and 
Offset Bit Pattern 
CSL Header 
0 (0) 4 
0 (0) 1 
1(1) 3 
4 (4) 8 
12 (C) 4 
16 (10) 2 
18 (12) 2 
20 (14) 12x32 
CSL Entry 
0 (0) 12 
0 (0) 8 
0 (0) 1 
1(1) 3 
4 (4) 4 
8 (8) 1 
| ee 
hs oe 
OOS cies 
well: 
eX XXXX 
9 (9) 3 


CTGCV—VSAM Catalog Control Volume List 


Field Name 


CSLRO 
CSLSUBPL 
CSLLENTH 
CSLID 
CSLNXPTR 


CSLACTEN 


CSLNTRYS 


CSLENTRY 
CSLFREMN 
CSLPOOLN 
CSLCORLN 
CSLCORPT 
CSLFLAGS 


CSLKEY5 
CSLKEY7 


CSLJSTCB 


CSLANCPT 


Description 


Used to load register 0 for FREEMAIN 
Subpool number of the CSL 

Length of the CSL 

Identifier: ‘bIDACSLb’ 


Address of the next CSL (zero for the last 
CSL in the chain) 


Number of active entries 
Reserved 


Entries for virtual-storage areas: 


An entry for a virtual-storage area: 
Information for FREEMAIN 

Subpool number of the virtual-storage area 
Length of the virtual-storage area 

Address of the virtual-storage area 

Flags: 


The storage is in key 5 

The storage is in key 7 

The storage is in key 0 or 
the key of the problem 
program 

The storage is owned by the 
job-step TCB 

Reserved 


Address of the header element in the HEB 
for the virtual-storage area, or zero 


The CTGCYV is built by the Scheduler to contain the volume and name of the 
OS/VS system catalog CVOL entry for a SUPERLOCATE request. CTGCV 
is mapped by IEZCTGCYV and is pointed to by CTGPL. 


Bytes and 
Offset Bit Pattern 
0 (0) 6 
6 (6) 4 


Field Name 


CTGCVVOL 
CTGCVDEV 


Description 


CVOL volume serial 
CVOL device type 
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CT GFL—Field Parameter List 


The CTGFL is built before an OS/VS component issues the CATLG macro 
instruction (SVC 26) to process a catalog record. The CTGFL defines one of 
the catalog record’s fields or a group of logically related fields (identified by a 
combination name). The CTGFL is used in two situations: 


e It identifies catalog record information to retrieve or update. The CTGPL 
contains the address of each CTGFL used in this way. 


¢ It identifies catalog record information to compare against caller-supplied 
data. This is a “test” CTGFL and is addressed by another CTGFL. 


When a catalog management routine is processing a CTGFL, the CTGFL’s 
address is in the CCA (CCAFLPT or CCATEST). 


CTGFL—Field Parameter List 
Bytes and 
Offset Bit Pattern Field Name 
0 (0) 1 CTGFLDNO 
1 (1) 1 CTGFLDCD 
x‘00’ 
X‘non00’ 
x‘80’ 
x‘70’ 
X‘20’ 
X‘40’ 
X‘A0’ 
xX‘CO’ 
xX‘80’ 
X‘10’ 
X‘40’ 
2 (2) 1 CTGFLDGC 
3 (3) 1 CTGFLDRE 
XXXX XXX. 
...0 
el 
4 (4) 4 CTGFLDWA 
8 (8) 4 CTGFLDNM 
12 (C) CTGFLCHN 
16 (10) CTGFLDAT 


(CTGFLDNO «x 8) 


Description 
Number of entries in CTGFLDAT 
Test condition: 


The CTGFL describes a field to be updated 
or retrieved. The CTGFL is pointed to by the 
caller’s CTGPL (CTGFIELD entry). 


The CTGFL describes a test condition. The 
CTGFL is pointed to by another CTGFL. 


Test condition: 


Equal 

Not equal 

Greater than 

Less than 

Greater than or equal 

Less than or equal 

Test under mask for zeros 
Test under mask for ones 
Test under mask for mixed 


Type code number 
Test results: 


Reserved 
Successful test 
Test failed 


Work area: contains information about the 
catalog record’s field name from the 
dictionary 


Address of the field name 
Address of a CTGFL-for-tests, or 0 


Address and length, in the caller’s work 
area, of: 


e« Each field that was retrieved, if the 
request was LOCATE or LISTCAT. 


« New data to replace or add to data in the 
catalog record, if the request was 
UPDATE, DEFINE, or ALTER. 


« Data used to compare to catalog record 
fields, if the CTGFL isa 
CTGFL-for-tests. 
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CTGFV—Field Vector Table 


The CTGFV is built by the Access Method Services (AMS) utility programs 
and contains addresses of user-supplied information fields and lists. The 
CTGFYV is built when the user issues a DEFINE or ALTER command. If the 
user is Creating a cluster, a CTGF'V is built for each catalog record that will 
be built to describe the cluster: that is, Access Method Services builds a 
cluster CTGFV, a data CTGFV, and, if the cluster is key-sequenced, an index 
CTGFV. The CTGFYV is pointed to by the CTGPL (CTGFVT). If Access 
Method Services builds more than one CTGFYV, the cluster CTGFYV is 
pointed to by the CTGPL (CTGFVT) and the data and index CTGFVs are 
pointed to by the cluster CTGFV. 


Bytes and 
Offset Bit Pattern Field Name Description 
0 (0) 1 CTGFVTYP The CTGFYV contains information used by 
the catalog management service’s DEFINE 
routines to build a catalog record of the type: 
C‘A’ NonVSAM 
C‘C’ Cluster 
C'D’ Data 
C‘'G’ CTGFVAIX Alternate index 
CT’ Index 
C'R’ CTGFVPTH Path 
C‘V’ Volume 
1 (1) 1 CTGFVPRO Catalog management services processing 
option flags: 
CTGFVAVL ALTER: Add volumes 
CTGFVRVL ALTER: Remove volumes 
CTGFVNDC No device-type conversion 
ese CTGFVDRC DEFINE a recoverable catalog 
XXXX Reserved 
2 (2) 1 CTGFVELM Element number of CMSPCATR 
3 (3) 1 Reserved 
4 (4) 4 CTGFVDCH Address of the cluster’s data CTGFV 
8 (8) 4 CTGFVICH Address of the cluster’s index CTGFV 
12 (C) 4 CTGFVVCH Address of the space vector table 
16 (10) 4 CTGFVIND Address of the associated DD statement 
20 (14) 4 CTGFVENT Address of the entry name CTGFL 
24 (18) 4 CTGFVSTY Address of the security information CTGFL 
(passwords, codeword, and number of tries) 
28 (1C) 4 CTGFVOWN Address of the owner identification CTGFL 
32 (20) 4 CTGFVEXP Address of the expiration date CTGFL 
36 (24) 4 CTGFVCRE Address of the creation date CTGFL 
40 (28) 4 CTGFVVLT Address of the volume serial number list 
44 (2C) 4 CTGFVRNG Address of the key range list 
48 (30) 4 CTGFVDVT Address of the device type CTGFL (for 
NonVSAM DEFINE only) 
52 (34) 4 CTGFVSPC Address of the space allocation information 
CTGFL 
56 (38) 4 CTGFVAMD Address of the AMDSB CTGFL (if VSAM 
DEFINE) 
CTGFVFSN Address of the file sequence number 


(if NonVSAM DEFINE) 
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Field Vector Table (CTGFV)—Description and Format 


Bytes and 
Offset Bit Pattern Field Name Description 
60 (3C) 4 CTGFVATR Address of the data set attributes CTGFL 
64 (40) 4 CTGFVBUF Address of the buffer size CTGFL 
68 (44) 4 CTGFVLRS Address of the average record size CTGFL 
72 (48) 4 CTGFVEXT Address of exception exit parameter list 
76 (4C) 4 CTGFVUPG Address of alternate index/path parameter 
list 
80 (50) 4 CTGFVNAM Address of the related name 
84 (54) CTGFVPWD Address of related object’s password 
88 (58) CTGFVWKA Address of the CRA feedback area 
CTGPL—Catalog Parameter List 


The CTGPL is built before an OS/VS component issues the CATLG macro 
instruction (SVC 26) to process a catalog record. The CTGPL defines the 
catalog management request and its options, the catalog record to be 
processed, and the VSAM catalog that contains the record. The CTGPL is 
pointed to by register 1. When the catalog management routines build a CCA 
to support the request, the address of the CTGPL is put into the CCA 


(CCACPL). 
Bytes and 
Offset Bit Pattern Field Name Description 
0 (0) 1 CTGOPTNI1 First option byte: 
CTGBYPSS Bypass the catalog management security 
verification processing 
CTGMAST Check the master password 
CTGCI Check the control interval password 
ae CTGUPD Check the update password 
| eae CTGREAD Check the read password 
ale, CTGNAME The CTGENT field contains the address of 
a 44-byte dsname, or a 6-byte volume 
serial number (padded with binary Os) 
0.. The CTGENT field contains the address of 
a 3-byte control interval number 
CTGCNAME The CTGCAT field contains the address of a 
44-byte catalog dsname or the address 
of an OS/VS system catalog CVOL entry 
The CTGCAT field contains the address of a 
4-byte field that contains the address of a 
VSAM catalog’s ACB 
Reserved 
1 (1) 1 CTGOPTN2 Second option byte: 
CTGEXT Extend option (with UPDATE) 
CTGERASE Erase option (with DELETE) 
CTGSMF Write SMF record option (with LSPACE) 
CTGPURG Purge option (with DELETE) 
CTGVMNT The caller is VSAM Open/Close/EOV: 
Volume Mount and Verify routine 
(IDA0192V) 
— CTGGTNXT Get-next option (with LISTCAT 
Teds CTGDISC Disconnect option (with DELETE) 
=P CTGOVRID Erase override option (with DELETE) 
CTGSCR Scratch space option (with DELETE) 


Reserved 
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Catalog Parameter List (CTGPL)—Description and Format 


Offset 
2 (2) 


3 (3) 


4 (4) 


8 (8) 


12 (C) 
16 (10) 


16 (10) 


17 (11) 


Bytes and 
Bit Pattern 


Field Name 


CTGOPTN3 
CTGFUNC 


CTGSUPLT 


CTGSRH 


CTGNUM 


CTGAMO 


CTGOPTN4 


CTGBYPMT 


CTGENT 


CTGFVT 
CTGCAT 


CTGCVOL 


CTGWKA 
CTGDSORG 


CTGOPTNS 


Description 
Third option byte: 


Specifies the caller-requested function: 
LOCATE 

LSPACE 

UPDATE 

A Catalog Management Services 
function (see CTGOPTNS) 
Super-Locate function 

Reserved 

Search the OS/VS system catalog first 
Search the VSAM catalog first (specified by 
CTGCAT or, if CTGCAT = 0, search 
the VSAM catalogs available to 

the caller) 

Search only one catalog (specified by 
CTGCAT) 

Search as many catalogs as are available 
The call is a VSAM catalog management 
request 

The call is a nonVSAM request 


Fourth option byte: 
Reserved 


Bypass security prompting to system 
operator 


Address of the catalog record identifier, as 
defined in CTGOPTN1. 
Address of the caller’s CTGFV 


Address of the catalog’s dsname or a 4-byte 
field that contains the address of the 
specified in CTGOPTN1 

Address of an OS/VS system catalog CVOL 
entry, if the request is SUPERLOCATE 


Address of the caller’s work area 


Data set organization, if the request is 
SUPERLOCATE 


Catalog Management Services request 
options: 


DEFINE 
ALTER 
DELETE 
LISTCAT 
CONVERTV 
Reserved 


Reserved 


Data Areas 587 


Catalog Parameter List (CTGPL)—Description and Format 


CTGVL—Volume List 


Bytes and 
Offset Bit Pattern Field Name Description 
18 (12) 1 CTGTYPE Type of catalog record: 
C‘D’ Data 
CT Index 
CA’ NonVSAM 
CU’ User catalog 
Cv’ Volume 
CC’ Cluster 
C‘M’ Master catalog 
CG’ Alternate index 
C‘R’ Path 
Cy’ Upgrade 
CF’ Free 
19 (13) 1 CTGNOFLD Number of entries contained in CTGFIELD 
20 (14) 4 CTGDDNM Address of the DD statement, if one is 
associated with this request 
CTGNEWNM Address of the new dsname, if the request is 
ALTER and the object’s name is being 
changed 
If the request is Super-Locate: 
20 (14) 2 CTGFDBK Feedback area 
22 (16) 1 CTGFBFLG Flags: 
CTGPAR Parallel mount 
sie talbes CTGKEEP Forced keep 
.-XX XXXX Reserved 
23 (17) 1 Reserved 
24 (18) 4 CTGJSCB Address of the JSCB 
CTGPSWD Address of the caller-supplied password 
28 (1C) VL CTGFIELD The address of each CTGFL, to specify 


each catalog field to be processed. The length 
of CTGFIELD is four times the 
CTGNOFLD value. 


The CTGVL is built by the issuer of a locate request for a data-set name. 
Catalog management uses the CTGVL to return to the caller the volume 
serial numbers of the volumes on which space is allocated to the data set. For 
superlocate requests, the CTGWA points to the CTGVL. 


Bytes and 
Offset Bit Pattern Field Name Description 
0 (0) 6 CTGVLVOL Volume serial number 
6 (6) 4 CTGVLDEV Device type 
10 (A) 2 CTGVLSEQ File sequence number 
12 (C) 3 CTGVLTTR For a single-volume data set, the TTR of its 
DSCB 
12 (C) VL For a multi-volume data set, a repetition of 


CTGVLVOL, CTGVLDEV and 
CTGVLSEQ for the rest of the volumes 
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CTGWA—Work Area 


The CTGWA is built by the caller of catalog management for most requests. 


The CTGPL points to the CTGWA. 


The work area has one format for a superlocate request and another format 


for all other requests. 


Format for a Request Other Than Superlocate 


Bytes and 
Offset Bit Pattern Field Name 
0 (0) 2 CTGWALNG 
2 (2) VL * 


Format for a Superlocate Request 


Bytes and 
Offset Bit Pattern Field Name 
0 (0) 4 CTGWAVL 
4 (4) 2 CTGWALV 
6 (6) 2 CTGWAVCT 
8 (8) 2 CTGWAUCT 


DIWA—Data Insert Work Area 


Description 


Length of the work area 


Data returned for DEFINE, DELETE, 
GENDSP, LISTCAT, LOCATE, LSPACE 


Description 


Address of the CTGVL (volume list) 
Length of the volume list 


Number of volume serial numbers returned 
in the volume list 


Minimum number of volumes that must be 
mounted 


The DIWA is a work area used by the control area and control interval 
splitting modules. The DIWA is pointed to by the data AMB (AMBIWA). 


Bytes and 


Offset Bit Pattern Field Name 


0 (0) | DIWID 
1 (1) I DIWATV 


2 (2) 2 DIWLEN 
4 (4) 1 DIWFLG1 


Dh cote DIWCAS 
whee @xss DIWCISPL 


Fos ae DIWPFERR 
ee ee DIWEOKR 


lia DIWGSPC 


a ale DIWSHIFT 
ail DISNOT1 


waiay sae 1 DIW1ST 


5(5) ] DIWFLG2 
| ere DIWFSPF 


Description 


Control block identifier, X°41’ 


Test-and-set (TS) assembler instruction is 
issued against this field to obtain exclusive 
use of the DIWA 


Length of a DIWA in bytes 
Flag byte 1: 


Control-area split is in progress 
Control-interval split has been 

performed 

I/O error occurred during preformating 
Key of a record to be inserted in a key-range 
data set is greater than the highest possible 
key in the current key range; this 

end of key-range condition causes a 
control-interval split 

Spanned record needs a new 

control area 

There is a shift in the insert point 

The buffer had intermediate or last segment 
of a spanned record 

The buffer had first or intermediate segment 
of a spanned record 


Flag byte 2: 


Preformatting is needed in an 
entry-sequenced data set 
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DSL—DEB Save List 


Data Insert Work Area (DIWA)—Description and Format 


Offset 


6 (6) 
8 (8) 


12 (C) 


16 (10) 


20 (14) 


24 (18) 


28 (1C) 


Bytes and 
Bit Patten 


-XXX XXXX 
2 
4 


20 


Field Name 


DIWLRBA 


DIWHRBA 


DIWPLH 


DIWBUFC 


DIWSPLTP 


DIWSAVE 


Description 
Reserved 
Reserved 


Address of the first control interval in a 
control area which is being split 


Address of the last control interval ina 
control area which is being split 


Address of the PLH which is currently 
associated with the DIWA 


Address of the BUFC which controls the 
insert work buffer 


Address of the RDF associated with the first 
record to be moved to a new control interval 
as a result of a control-interval split 


Register save area 


The DSL contains up to 16 entries that describe DEBs that have been 
successfully chained and added to the DEB table. It enables Open to free the 
DEBs if an error prevents them from being freed normally. 


The DSL is pointed to by OPWA (called the ACB work area). Additional 
DSLs are chained as required. 


Offset 


0 (0) 
1(1) 
4 (4) 
12 (C) 


16 (10) 
18 (12) 
20 (14) 
20 (14) 


21 (15) 


Bytes and 
Bit Pattern 


>, © Ww — 


N 


4x 16 


XXXX XXX. 


3 


Field Name 


DSLSUBPL 
DSLLENTH 
DSLID 
DSLNXPTR 


DSLACTEN 


DSLENTRY 
DSLFLG 
DSLFDDEB 


DSLDEBAD 


Description 


Subpool number of the DSL 
Length of the DSL 
Identifier: ‘6IDADSLDb’ 


Address of the next DSL (zero for the last 
DSL in the chain) 


Number of active entries 
Reserved 

Entries for DEBs: 

Flags: 


The DEB is a dummy DEB 
Reserved 


Address of the DEB 
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EDB—Extent Definition Block 


The EDB describes all extents of the space allocated to the cluster’s data set. 
The EDB is built by the VSAM Open routine from information in the data 


ESL—Enqueue Save List 


set’s catalog record. 


The EDB header contains the length of the EDB and the number of EDB 
entries that follow the header. Each EDB entry describes an extent, and 
contains the address of the associated LPMB. The EDB header is pointed to 
by the AMB (AMBEDB). 


Bytes and 
Offset Bit Pattern 
EDB Header Definition 
0 (0) 1 
1 (1) 1 
2 (2) 2 
4 (4) 4 
EDB Entry Definition 
0 (0) 3 
3 (3) 1 
4 (4) 4 
8 (8) 
12 (C) 4 
16 (10) 4 


Field Name 


EDBIDID 
EDBNO 


EDBLEN 
EDBLPMBC 


EDBM 


EDBLPMBA 
EDBSTTRK 


EDBLORBA 
EDBHIRBA 


Description 


Control block identifier, X°90’ 


Number of EDB entries—one EDB per 
logical extent 


Length of an EDB entry in bytes 
Address of first LPMB 


Reserved 


Extent number; specifies the relative location 
of an extent entry ina DEB 


Address of LPMB 


Relative track address of the extent 
associated with this EDB 


RBA of the start of the extent 
RBA of the end of the extent 


The ESL contains up to 16 entries that describe ENQ requests that have been 
completed during Open. It enables Open to dequeue the indicated resources if 
an error prevents them from being dequeued normally. 


The ESL is pointed to by OPWA (called the ACB work area). Additional 
ESLs are chained as required. 


Offset 


0 (0) 
1 (1) 
4 (4) 
12 (C) 


16 (10) 
18 (12) 
10 (14) 
20 (14) 


21 (15) 


21 (15) 


Bytes and 
Bit Pattern 


1 


E_ CO WwW 


Field Name 


ESLSUBPL 
ESLLENTH 
ESLID 
ESLNXPTR 


ESLAC TEN 


ESLENTRY 
ESLENQOP 


ESLRNAME 


ESLCINBR 


Description 


Subpool number of the ESL 
Length of the ESL 
Identifier: ‘6IDAESLDb’ 


Address of the next ESL (zero for the last 
ESL in the chain) 


Number of active entries 
Reserved 
Entries for resources enqueued: 


The ENQ option that was used for this 
resource 


ENQ resource name (minor) that identifies 
this resource: 


Control-interval number for the resource 
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ESL—Enqueue Save List 


Bytes and 
Offset Bit Pattern Field Name Description ; 
24 (18) 4 ESLACBAD Address of the ACB of the catalog for the | 
resource 
28 (1C) 1 ESLIO Indicator of the purpose of the ENQ: 
I input 
0 output 


EXLST—Exit List 


The EXLST contains addresses for the user-exit processing routines EODAD, 
SYNAD, LERAD, and JRNAD. The address of the EXLST is in the ACB 


(ACBEXLST). 
Bytes and 
Offset Bit Pattern Field Name Description 
0 (0) 1 EXLID Control block identifier, X‘81’ 
1 (1) | EXLSTYP Subtype identifier: 
X*10’ = VSAM 
X‘20’ = VTAM 
2 (2) 2 EXLLEN Length of the control block 
4 (4) 1 Reserved 
5 (5) 1 EXLEODF Entry description 
6 (6) 4 EXLEODP Address of the EODAD exit routine 
10 (A) 1 EXLSYNF Entry description 
11 (B) 4 EXLSYNP Address of the SYNAD exit routine J 
15 (F) 1 EXLLERF Entry description 
16 (10) 4 EXLLERP Address of the LERAD exit routine 
20 (14) | EXLUPADF Entry description 
21 (15) 4 EXLUPADP Address of the UPAD exit routine 
25 (19) 5 Reserved 
30 (1E) 1 EXLJRNF Entry description 
31 (IF) 4 EXLJRNP Address of the JRNAD exit routine 
35 (23) 10 Reserved 
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HEB—Header Element Block 


The HEB is used by Virtual-Storage Management to allocate and free 
unprotected storage blocks. It contains 16 header elements, each of which 
describes a storage block. It is further described in “‘Virtual-Storage 


Management”’ in “‘Diagnostic Aids.” 


The HEB is pointed to by the BIB (BIBHEBPT). The first free header 


element is pointed to by BIBHEBFQ. 


Field Name 


HEBID 


HEBLEN 


HEBNHEB 


HEBCNT 
HEBHDELS 


HEBFREMN 


HEBSP 
HEBLN 
HEBBLKPT 
HEBFLAGS 
HEBPGBDY 


HEBAVSP 


HEBELCHN 


Bytes and 
Offset Bit Pattern 
HEB Block Definition 
0 (0) | 
1 (1) | 
2 (2) 2 
4 (4) 4 
8 (8) Z 
10 (A) 2 
12 (C) 20 x 16 
HEB Header Element Definition 
0 (0) 8 
0 (0) | 
1() 3 
4 (4) 4 
8 (8) 1 
| er 
.XXX XXXX 
9 (9) 3 
12 (C) 4 
16 (10) 4 


ICWA—Index Create Work Area 


HEBNBYTE 


Description 


Control block identifier, X‘13’ 
Reserved 


Length of the HEB (including header 
elements) 


Address of the next HEB (or 0) 
Reserved 
Number of header elements in use 


Header elements: 


Information for freeing the storage block 
described by this header element: 


Subpool in which the storage block is located 
Length of the storage block 

Address of the storage block 

Flags: 


The storage block is on a page boundary 
Reserved 


Amount of space available in the storage 
block 


Address of the next header element 


Address of the next available byte 


The ICWA contains information needed when a VSAM index record is being 
built or modified during key-sequenced data set creation. The ICWA is 
pointed to by the index AMB (AMBIWA). 


Bytes and 


Offset Bit Pattern 


0 (0) 1 
1 (1) 1 


Field Name 


ICWID 
ICWFLGI1 


ICWWNF 
ICWWAGM 
ICWRBAOK 
ICWVSE 
ICWVNE 
ICWKRDS 
ICWSPLIT 
ICWENDRQ 


Description 


Control block identifier, X‘43’ 
Flag byte: 


Entry won’t fit in the index record 

The Open routine did not supply a work area 
Don’t get RBA on initial 

The section entry is valid 

The previous entry is valid 

The data set is divided into key ranges 

The work area contains a split index record 
The Close routine requires a control interval 
split 
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Index Create Work Area (ICWA)—Description and Format 


Bytes and 

Offset Bit Patten Field Name Description 

2 (2) 2 ICWLEN Length of the ICWA 

4 (4) 4 ICWCHN Address of the next ICWA 

8 (8) 4 ICWBUFC Address of the current index BUFC 

12 (C) 4 ICWCRBA Current index RBA 

16 (10) 4 ICWPRBA Previous index RBA 

20 (14) 2 ICWPSEO Displacement from the beginning of the 
index record to the prior section entry 

22 (16) 2 ICWSCNT Number of entries in the current section 

24 (18) 4 ICWADD Address of the current work area 

28 (1C) 4 ICWTBASE Base RBA 

32 (20) 4 ICWTPTR Address of the index save position 

36 (24) 4 ICWARDBP Address of the current ARDB 

40 (28) 2 ICWLN Index level number 

42 (2A) 4 ICWKEYI1L Length of the current key 

44 (2C) 2 ICWKEY2L Length of the previous key 

46 (2E) 2 ICWKEY3L Length of the section key 

48 (30) 2 ICWNEST Number of entries in the index section 

50(32) 2 ICWNOSEG Number of segments in a spanned record 

52(34) 2 ICWCRSEG Number of the segment being processed 

54 (36) 1 ICWREQ Request type 

55 (37) 1 ICWPTL Index entry pointer length 

56 (38) 1 ICWCER Rear compression count of the current index 

entry 

57 (39) 1 ICWCEF Current index entry F—number of front-key 
compressed bytes 

58 (3A) 1 ICWCEL Current index entry L—length of the 
compressed key in the entry 

59 (3B) 1 ICWCERP Rear compression count of the previous 
index entry 

60(3C) (keylength) ICWKEY1 Save area for the current key 

VL (key length) ICWKEY2 Save area for the previous key 

VL (key length) ICWKEY3 Save area for the section key 
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IICB—ISAM Interface Control Block 


The IICB is used to address the DCB (ISAM) and the ACB and RPL 
(VSAM) control blocks and associated areas needed by the ISAM interface. 
The IICB is pointed to by the DEBWKPTS field in the ISAM DEB to provide 
integrity and by the RPLIICB field in the RPL Extension to provide the 
connection to VSAM control programs. 


Offset 


0 (0) 
1 (1) 
2 (2) 
4 (4) 
8 (8) 
12 (C) 
16 (10) 
16 (10) 
18 (12) 
20 (14) 
24 (18) 


25 (19) 


28 (1C) 


29 (1D) 


32 (20) 
34 (22) 


36 (24) 


37 (25) 


Bytes and 
Bit Pattern 


| 


kN NY fF Ff KF FL NY = 


— 


3 


1 


-XXX XXXX 


3 


Field Name 


IICBID 


IICBLEN 
IIDCBPTR 
ILACBPTR 
IIRPLPTR 
IIW1CBF 
HSAVLRL 
IIMAXLRL 
NKEYPT 
IIFLAG1 


IIFSCAN 
ITFGET 
IIFPASS 
IIFCLOSE 
IIDATA 
IIFTEST 


IIQBFRS 


TACBL 


IWFLAG2 


MRKP 
MLRECL 
MBLKSI 
MOPTCD 
MRECFM 
MBUFL 
MBUFNO 
MKEYLE 


ITRPLL 


IIKEYSL 
IIBUFL 


IIFLAG3 
MBFALN 


IIMSGL 


Description 


IICB identifier, X°80’. 

Reserved. 

Length of IICB, in bytes. 

Address of DCB. 

Address of ACB. 

Address of RPL. 

Address of dummy work area (scan mode). 
Previous DCBLRECL value (load mode). 
Maximum DCBLRECL value (load mode). 
Address of key (dummy ISAM) save area. 
ISAM interface status flags: 


Scan mode. 

First GET request. 

First pass in load mode. 

Close in process. 

Data only retrieval. 

Loop test bit. 

Reserved 

QISAM does not use buffers—no 
FREEMAIN is required. 


ACB, EXLST, IICB length for 
GETMAIN/FREEMAIN. 


ISAM interface status flags used by Open to 
designate the fields being merged by ISAM 
Interface. ISAM Interface Close uses the 
same mask to restore the DCB to its pre-open 
status. 


Relative key position. 
Logical record length. 
Block size. 

Option code. 

Record format. 
Buffer length. 

Buffer number. 

Key length. 


RPL and RPLE: length for 
GETMAIN/FREEMAIN. 


Length of key save area, in bytes. 


Length of single ISAM Interface buffer (used 
in calculations). 


ISAM interface status flags: 


BFALN merge bit. 
Reserved. 


Message area length. 
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ISAM Interface Control Block (II1CB)—Description and Format 


Bytes and 
Offset Bit Pattern Field Name Description ’ 
40 (28) 4 IIMSGPTR Message area pointer. - 
44 (2C) 1 IIBUFNO Number of ISAM Interface buffers built by 
Open. 
45 (2D) 3 IITBUFL Total BCB and buffer length for 
GETMAIN/FREEMAIN. 
48 (30) 4 IISVCLST SVC exit for SYNADAF. 
52 (34) 8 IISAMSYN ISAM SYNAD name—used when SYNAD is 
specified in the AMP parameter. 
60 (3C) 72 IIREGSAV Register save area. 
60 (3C) 4 Reserved 
64 (40) 4 ITREGBC Previous save area pointer. 
68 (44) 4 IIREGFC Next save area pointer. 
72 (48) 60 Remainder of save area. 


IMWA—lIndex Insert Work Area 


The IMWA is a control block used in inserting an index entry into the index 
of a key-sequenced data set. The IMWA is created by the Open routine, and 
is pointed to by the ICWA (ICWCHN). 


Bytes and 

Offset Bit Pattern Field Name Description 

0 (0) | IMWID IMWA identifier, X°42’ 

1 (1) 1 IMWFLAGS Control flags: J 

| ere IMWNEWHL Indicates a new high level should be built 
in the index structure. 

shes weg: IMWRIPL Indicates a new entry must be built in an 
index record at the next higher level to 
reflect a new index record created by an 
index split. 

allie: Gas IMWBSE Indicates the new index entry should be a 
section entry. 

eX XXXX Reserved. 

2 (2) 2 IMWLEN Length of IMWA in bytes. 

4 (4) 4 IMWIXSP Address of index search parameter list. 

8 (8) 32 IMWISWKA Index search parameter list (see IXSPL 
control block description). 

40 (28) 4 IMWXKEYP Address of the next (higher-keyed) index 
entry. 

44 (2C) 4 IMWIKEYP Address of the new index entry’s key. 

48 (30) 4 IMWXPTR Value of the index pointer field in the next 
(higher-keyed) index entry. 

52 (34) 4 IMWIPTR Value to be inserted in new index entry’s 
pointer field. 

56 (38) 4 IMWLBUFC Address of a data BUFC for a data buffer 
containing the lowest key following a control 
area split. 

60 (3C) 4 IMWBUFP Address of the index record being processed. ) | 
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Index Modification Work Area (IMWA)—Description and Format 


Offset 
64 (40) 


65 (41) 


66 (42) 
67 (43) 
68 (44) 


70 (46) 
72 (48) 
76 (4C) 


Bytes and 


Bit Pattern 


1 


2 
4 
(key length) 


IOB Extension to Support VSAM Processing 


The VSAM extension to the basic direct-access IOB (offset is 40 bytes 
(X‘28’) from the start of the IOB) contains information used by VSAM I/O 
Management for OS/VS I/O Supervisor to process VSAM I/O requests. 


Field Name 
IMWFGAIN 


IMWIEL 


IMWSVIEL 


IMWCIMVN 


IMWNSOFF 


IMWKEY 1 


Description 


Front key-compression adjustment to be 
added to IBFLPF field in next (higher-keyed) 
index entry. 


Value of IBFLPL field, that is, compressed 
length of new index entry’s key. 


Save area for IBFLPL value. 
Reserved. 


Readjustment to number of control intervals 
in old control area following a control area 
split to enable an index record to be built for 
the new control area. 


Offset to next section entry in index record. 
Reserved. 


Highest possible key for a mass insertion; 
that is, last key in a sequence of keys to be 
inserted which is less than an existing key. 
Also, save area for current insert key under a 
no-fit condition. 


See OS/VS1 System Data Areas for basic direct-access IOB details. 


Offset 


Bytes and 


Bit Pattern 


Field Name 


Description 


Note: These fields are located in the IOB at X‘28’, + X ‘offset value’. 


0 (0) 


4 (4) 


5 (5) 
6 (6) 
7 (7) 
8 (8) 
10 (A) 


12 (C) 
16 (10) 


20 (14) 


4 


XXXX 


IOBBUFCS 


IOBIOMF 


IOBAMUSE 
IOBMCSW 


IOBEOVW 
IOBEOVTS 


IOBNMOD 
IOBLOCK 


IOBNBUF 
IOBNSEG 


IOBPLH 
IOBR14 


IOBVSL 


Address of the BUFC for current I/O 
processing 


Flags: 


The IOB is in use 

The address in the CSW is not ina VSAM 
channel program 

The VSAM End of Volume routine is waiting 
The VSAM End of Volume routine set the 
IOBLOCXK field 

Reserved 


Number of modules in the virtual storage list 
Process lock 

Reserved 

Number of buffers reserved for this request 


Number of channel program segments for 
this request 


Address of the PLH 


Save area that contains the return address to 
the I/O Supervisor when an appendage 
module is called 


Address of the virtual storage list 


Data Areas 597 


VSAM Extension to the Input/Output Block (IOB)—Description and Format 


Offset 
24 (18) 


48 (30) 
52 (34) 


Bytes and 


Bit Pattern 


IXSPL—Index Search Parameter List 


The IXSPL is used to pass index search parameters to the index search 
routine. It also contains status information about the results of the search. It is 
used as a work area by the SCIB (Search Compressed Index Block) routine 
(IDA019RC). The PLH contains the address of the IXSPL (PLHISPLP) or 
the contents of the IXSPL (PLHIXSPL). 


Offset 


0 (0) 
4 (4) 
8 (8) 
12 (C) 


13 (D) 


14 (E) 
17 (1) 


18 (12) 


19 (13) 


20 (14) 


24 (18) 


28 (1C) 


Bytes and 
Bit Pattern 


oeXX 


24 


4 


- bh Ft 


XXXX 


Field Name Description 
IOBMSAV!1 Six 4-byte work areas 
through 

IOBMSAV6 

REGI1 Register save area 
IOBIQE Address of the IQE 


Field Name Description 
IXSSTRBA RBA of the index record to search first. 
IXSBUFC Address of the index BUFC 
IXSARG Address of the search argument (a key field) 
IXSTLN Index level number at which the search is to 
terminate 
IXSILN Index level number at which the search is to 
begin 
Reserved 
IXSBFLG Flags: 
IXSSSRH Used by the Search Compressed 
Index Search routine: search for a section 
entry only 
Search for a normal entry 
IXSLELV The entry located by the Index 


Search routine is the last entry 
in the terminating level 
(F = 0 and L = 0) 


Reserved 

IXSEKON Length of the F, L, and pointer fields in each 
index entry 

IXSPEC The number of characters in the index entry 


preceeding the entry located by the Index 
Search routine that equalled the search 
argument 


IXSHEP Address of the index entry located by the 
Index Search routine 


IXSSEP Address of the section entry that is greater 
than or equal to the index entry located by 
the Index Search routine 


IXSLEP Address of the lowest-valued entry in the 
section identified by IXSSEP 
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C 


KEYWDTAB—Keyword Processing Table 


KEYWDTAB is a branch table that controls the execution of IDA019C1 and 
supports processing for the GENCB, MODCB, SHOWCB, and TESTCB 
macros. The table is built by and contained within IDA019C1 and is not 
referred to by any other module. The table contains one 14-byte row for each 
keyword processed by a control block macro, and each row is identified by a 
keyword-type code (0-255). Each column in the table represents functions 
for the keywords and contains index points for specific keyword functions. 
Each column also contains either offsets and lengths for byte-oriented fields 
or pointers to descriptive information about bit-oriented fields. The index 
points are used to route specific requests through IDA019C1 on the bases of 
keyword, block (ACB, RPL, and EXLST), and function (GENCB, MODCB, 
SHOWCEB, and TESTCB). 


Offset Bytes Description 

0 (0) 14 The description for the keyword with type code=0 
(KWO0) 

0 (0) 3 The index points for the ACB 

0 (0) 1 The index point for MODCB of the ACB 

1 (1) 1 The index point for SHOWCB of the ACB 

2 (2) 1 The index point for TESTCB of the ACB 

3 (3) 3 The index points for the EXLST 

3 (3) 1 The index point for MODCB of the EXLST 

4 (4) 1 The index point for SHOWCB of the EXLST 

5 (5) 1 The index point for TESTCB of the EXLST 

6 (6) 3 The index points for the RPL 

6 (6) 1 The index point for MODCB of the RPL 

7 (7) 1 The index point for SHOWCB of the RPL 

8 (8) 1 The index point for TESTCB of the RPL 

9 (9) 3 The index points for the NIB (VTAM) 

9 (9) 1 The index point for MODCB of the NIB 

10 (A) 1 The index point for SHOWCB of the NIB 

11 (B) 1 The index point for TESTCB of the NIB 

12 (C) 2 The offset to a bit definition, if this is a bit-level keyword 

13 (D) 1 The offset of the resultant field in the target field, if this is 
a byte field 

14 (E) 14 The description for the keyword with type-code=1 
(KW01) 

28(1C) 14 The description for the keyword with type-code=2 
(K W072) 

255 (FF) 14 The description for the keyword with type-code=255 


(KW255, the maximum value) 
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LPMB—Logical-to-Physical Mapping Block 


The LPMB contains information about the direct-access device that contains 
the user’s data set. The LPMB is built by the VSAM Open routines, using 
information in the data set’s catalog record. The EDB (EDBLPMBA) 


contains the address of the LPMB. 


Offset 


0 (0) 
1 (1) 


2 (2) 
4 (4) 


8 (8) 
12 (C) 


16 (10) 
18 (12) 
20 (14) 


22 (16) 
24 (18) 
28 (1C) 


OPW—Open Work Area 


Bytes and 
Bit Pattern 


oeeX XXX 


- 


VL 


Field Name 


LPMBID 
LPMBFLGS 
LPMBRPS 


LPMREPL 
LPMSS 


LPMBSSTH 


LPMBLEN 
LPMAUSZ 


LPMBPTRK 
LPMBLKSZ 


LPMTRKAU 
LPMTPC 
LPMBLKTR 


LPMBEXT 
LPMBSST_ 


Description 


Control block identifier, X ‘91’ 
Flags: 


The device has the rotational position 
sensing (RPS) feature 

Records are replicated on the track 
Sequence set records are stored with the data 
records 

The Set Sector table is 

included at the end of 

the LPMB 

Reserved 


Length of the LPMB 


The minimum number of bytes that can be 
allocated to an object. Allocation is always 
an integer multiple of LPMAUSZ. For a data 
component, this field is the control area size. 
For an index, this field is the device’s track 
size. 


Number of bytes per track 


Number of bytes per physical record (control 
interval) 


Number of tracks per allocation unit (extent) 
Number of tracks per cylinder 


Number of physical records (control 
intervals) per track 


Reserved 
Reserved for address of LPMB extension 


Set sector table ; 


OPW is the common work area used by VSAM Open routines. It is built by 
IDA0192A, mapped by IDAOPWRK, and pointed to by register 4 during 


VSAM processing. 


Open Work Area (OQPW)—Description and Format 


Offset 
0 (0) 
1(1) 
4 (4) 
12 (C) 


Bytes and 
Bit Pattern 


| 


Field Name 
OPWSUBPL 
OPWLENTH 
OPWID 
OPWFLGSI 


OPWCAT 
OPWSCRA 
OPWVVIC 


Description 

Subpool of work area 
Work area length 

Block ID—IDAOPWRK 
Flag byte 1: 


Catalog open 
System CRA open 
MSVI data set 
Reserved 
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Open Work Area (QPW)—Description and Format 


Offset 
13 (D) 


14 (E) 


15 (F) 


16 (10) 


20 (14) 
24 (18) 


28 (1C) 
32 (20) 
36 (24) 
40 (28) 
44 (2C) 
50 (32) 
52 (34) 
56 (38) 
60 (3C) 
64 (40) 
64 (40) 
68 (44) 
72 (48) 
76 (4C) 
80 (50) 
84 (54) 
88 (58) 
92 (SC) 
96 (60) 


Bytes and 
Bit Pattern 


| 


XXX. 


bho 
o fF fF FN ODO FL FL FF HK fF 


- f+ f£$ $f Lf $f FL FH LF 


Field Name 
OPWFLGS2 


OPWUCRA 
OPWIXDT 
OPWAIXDT 
OPWDUMMY 


OPWNOPFL 
OPWFLGS3 


OPWDAVAT 
OPWPUPGR 
OPWUPGOP 
OPWNOWRK 


OPWFLGS4 


OPWFULL 
OPWCINV 
OPWUPD 


OPWCURPT 


OPW2YPLH 
OPWCAMBL 


OPWBCON 
OPWPCON 
OPWBAMBL 
OPWPAMBL 
OPWCRA 


OPWBIB 
OPWUPT 
OPWUACB 
OPWSAVE 
OPWCSL 
OPWESL 
OPWPSL 
OPWDSL 
OPWSSL 
OPWWRKPT 
OPWDTWRK 
OPWIXWRK 
OPWCTCB 


Description 
Flag byte 2: 


User CRA open 

Index open as an ESDS 
Alternate index open for end use 
Open dummy data set 

Reserved 


Page fix list does not exist 
Flags for IDA0192B: 


Dummy AMBL added to VAT 
Path also in upgrade set 
Upgrade set open 

MOD work area does not exist 
Reserved 


Authorization flags: 


Full access 
Control-interval access 
Update access 
Reserved 


Address of cluster being processed. This field 
can point to OPWBSECL (548(224)), 
OPWPTAIX (556(22C)), OPWUPAIX 
(568(238)), and every 8 bytes thereafter, 
since OPWUPAIX is a repeating field. The 
format of current cluster information ts 
described below by OPWCURCL. 


Address of first PLH 


The address of the existing AMBL for 
connecting to an existing structure 


Address of base AMBL connecting to 
Address of path AMBL connecting to 
Address of AMBL for base 

Address of AMBL for path 

CRA volume serial number 

Reserved 

Address of the BIB 

Address of the upgrade table 
Address of the user ACB 

Addresses of save lists 

Address of core save list 

Address of ENQ save list 

Address of the page-fix save list 
Address of the DEB save list 

Address of the swap save list 

Address of current AMB work area 
Address of data AMB work area 
Address of index AMB work area 
Address of current TCB 
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Open Work Area (OPW)—Description and Format 


Bytes and 
Offset Bit Pattern Field Name Description 
100 (64) 4 OPWJSTCB Address of job step TCB J 
104 (68) 4 OPWTIOT Address of TIOT entry b 
108 (6C) 4 OPWCOMWA Address of Open common work area 
112 (70) 4 OPWBUFND Number of data buffers 
116 (74) 4 OPWBUFNI Number of index buffers 
120 (78) 1 OPWCSTRN Current string number 
121 (79) 1 OPWSTRNO Path string number, if path processing; 
otherwise, base string number 
122 (7A) 1 OPWBSTRN Base string number, if base processing 
123 (7B) 1 Reserved 
124 (7C) 8 OPWIDF Cluster identifier 
124 (7C) 4 OPWCACB Address of catalog ACB 
128 (80) 3 OPWDCI Control interval number of data component 
131 (83) 1 OPWQ Open qualifier: 
OPWDDC Connect by DD name 
OPWGSR Opened for GSR 
OPWLSR Opened for LSR 
OPWFSTP Opened for ICI 
ee OPWUBF Opened for user buffering 
als OPWKSDS Opened as a KSDS 
OPWESDS Opened as an ESDS 
OPWDFR Opened with deferred write option 
132 (84) 16 OPWVSMPL O/C/EOV Virtual Storage Manager 
parameter list } 
132 (84) 4 OPWVMANC Address of anchor block | 
136 (88) 1 OPWVMSP Subpool for direct request 
136 (88) 1 OPWVMTYP Request type 
137 (89) 3 OPWVMLNG Amount of storage requested 
140 (8C) 4 OPWVMADR Address of storage acquired (zero, if storage 
not obtained) 
144 (90) 1 OPWVMFLG Flag byte: 
OPWVMPGB Get storage on a page boundary 
OPWVMNSL Do not build a CSL for this request 
OPWVMDIR Direct request 
Reserved 
145 (91) 3 Reserved 
148 (94) 76 OPWVSMWA O/C/EOV Virtual Storage Manager work 
area 
148 (94) 4 OPWVANCP Pointer to the address of the first HEB 
header element associated with this request 
152 (98) 4 OPWVTBLP Address of the request table used by 
GETSPACE routine 
156 (9C) OPWVCSLE Address of core save list entry 
160 (AO) OPWVHDRE Address of header element 
164 (A4) 16 OPWVSAVE Save area for IDA0192M processing 
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Open Work Area (OPW)—Description and Format 


Offset 
180 (B4) 


0 (0) 
0 (0) 
1 (1) 
4 (4) 
8 (8) 


9 (9) 
216 (D8) 
228 (E4) 
228 (E4) 
229 (E5) 
232 (E8) 
236 (EC) 
288 (120) 
300 (12C) 


556 (22C) 
560 (230) 
560 (230) 
561 (231) 
564 (234) 
565 (235) 
568 (238) 
568 (238) 
569 (239) 


572 (23C) 
573 (23D) 
576 (240) 
577 (241) 
580 (244) 


0 (0) 
0 (0) 
1 (1) 


4 (4) 
5 (5) 


Bytes and 
Bit Pattern 


36 


12 


oS 

XX XXXX 
3 
12 


8 


=o 


CoO Ow! 


Field Name 


OPWVGSPL 
OPWVGSSP 
OPWVGETL 
OPWVGSPT 
OPWVGFLG 


OPWVGPGB 
OPWVGNSL 


OPWVREQL 
OPWVGMPL 
OPWVFMPL 
OPWVFMSP 
OPWVFMLN 
OPWVFMPT 
OPWDACB 
OPWSFI 
OPWERMAP 


OPWSAVEA 


OPWBSECL 


OPWBDTCI 


OPWBIXCI 
OPWPTAIX 


OPWPDTCI 


OPWPIXCI 
OPWNOUPG 


OPWUPAIX 


OPWUDTCI 


OPWUIXCI 


Description 


The following 12-byte field is repeated 3 
times: 


Get space parameter lists 
Subpool number 

Length of acquired storage 
Address of required storage 
Flags for Get space 


Get storage on a page boundary 
Do not build a CSL for this request 
Reserved 


Length of request 

GETMAIN parameter list 
FREEMAIN parameter list 
FREEMAIN subpool number 
FREEMAIN length 
FREEMAIN address 

Dummy ACB for opening base 
Subfunction information 


Map of return codes to ACBERFLG, where 
return code rc is defined in OS/VS Message 
Library: VSI System Messages for messages 
IECO701, IEC1611, IEC2511, and IEC252I1. 


Return address save area 

Base cluster information 

Reserved 

Base data control interval number 
Reserved 

Base index control interval number 
Path alternate index information 
Reserved 


Path alternate index data control interval 
number 


Reserved 

Path alternate index control interval number 
Number of upgrade alternate indexes 
Reserved 


The following 8-byte field, pointed to by 
OPWCURPT (16(10)), is repeated once for 
each upgrade alternate index associated with 
the base cluster being processed. 


Upgrade alternate index information 
Reserved 


Upgrade alternate index data control interval 
number 


Reserved 


Upgrade alternate-index control interval 
number 
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Open Work Area (OPW)——Description and Format 


Bytes and 
Offset 


0 (0) 8 
0 (0) 1 
La 
me 
a 
bis 
XXX 
1 (1) 3 
4 (4) 1 
be 
Fle 
ie 
| ee 
XXX 
5 (5) 3 


PCCB—Private Catalog Control Block 


Bit Pattern 


The format of information about the cluster being processed (pointed to by 
OPWCURPT (16(10)) is shown below: 


Field Name 


OPWCURCL 
OPWCFLGI 


OPWBASE 
OPWPATII 
OPWUPGR 
OPWSVWRK 
OPWPRTBL 


OPWCDTCI 
OPWFLG2 


OPWDOPEN 
OPWMODWK 
OPWEMPUP 
OPWERR2B 
OPWIOPEN 


OPWCIXCI 


Description 


Current cluster information 
Cluster flags (set by sphere Open): 


Open base cluster 

Open path alternate index 
Open upgrade alternate index 
Do not free AMB work areas 
Partial control-block build 
Reserved 


Data component control interval number 
Cluster flags (set by cluster Open) 


Open indicator on in catalog for data 
Module work area exists 

Empty upgrade data set 

Terminating error in IDA0192B 

Open indicator on in catalog for index 
Reserved 


Index component control interval number 


A PCCB describes each user’s catalog to the OS/VS system. The PCCB is 
built when the user’s catalog is opened. If the catalog is already open for 
another user, a PCCB is built when the user’s JCL DD STEPCAT or 
JOBCAT statement specifies the catalog. The JSCB associated with the user 


task’s TCB points to the first PCCB. Other PCCBs available to the user’s 
task are chained form the first PCCB. 


Bytes and 

Offset Bit Pattern 

0 (0) 4 

4 (4) 4 

8 (8) 4 

12 (C) 

12 (C) 1 

13 (D) 3 

16 (10) 4 

16 (10) | 
Lesiesee 
.XXX XXXX 


17 (11) 3 


Field Name 
PCCBNXT 
PCCBACB 


PCCBTCE 
PCCBCORE 


PCCBSBP 
PCCBLNG 


PCCBSTS 
PCCBST1 
PCCBOPN 


J 


Description 
Address of the next PCCB 


Address of the ACB for the VSAM user’s 
catalog 


Address of the TIOT chaining element 


Information used with GETMAIN and 
FREEMAIN requests: 


Subpool number 


Amount of virtual storage for the PCCB, 
TCE, and AT 


Status bytes 
Status Flags: 


The VSAM user’s catalog was opened 
Reserved 


Reserved 
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PLH—Placeholder 


The PLH contains current information about a string of requests. This 
information includes positioning information, request options, and buffer 
location and status. The PLH is built by the Open routine and is pointed to by 
the AMB (AMBPH). The next PLH in the chain is pointed to by 
PLHCHAIN. When a record management routine is processiug a PLH, the 
PLH’s address is in register 2 (RPLH). 


Bytes and 


Offset Bit Pattern Field Name Description 
PLH Header 
0 (0) 1 PLHID Control block identifier, X*30’ 
1 (1) 1 PLHCNT Number of PLH entries that follow the 
header 
2 (2) PLHELTH Length of each PLH entry 
4 (4) PLHDRREQ Count of requests that have been deferred 
8 (8) PLHDRMAX Maximum number of placeholders (PLH 
entries) in concurrent use 
10 (A) 2 PLHDRCUR Number of active placeholders 
12 (C) 4 PLHIOSDQ Data-Set Management (I/O Support) 
deferral queue header 
PLH Entry 
0 (0) | PLHAVL Zero if the PLH entry is available 
1 (1) 1 PLHATV Zero if there are no active requests 
2 (2) 1 PLHFLG1 Process flag byte 1: 
| eee PLHEOVW The VSAM End of Volume routine is waiting 
pee PLHENDRQ The caller issued an ENDREQ request 
silecee PLHASKBF Less than maximum buffers 
toa Vides PLHSSR The sequence set is stored with the data 
pera es PLHRDEXC Read exclusive mode 
ae ler PLHASYRQ IRB execution needed 
dl’ PLHDRPND A deferred request is pending 
bande x Reserved 
3 (3) | PLHFLG2 Process flag byte 2: 
Liscive PLHUPD The previous request was a GET-for-update 
hak PLHSQINS Sequential insertion mode 
esi ee PLHKEYMD Keyed mode 
i eee PLHADDTE Add to the end processing 
aes [ake PLHKRE End of key range indicator 
es oe PLHCIINS Control interval split insertion 
weil PLHSVADV Save the PLHNOADYV field during 
Scan Data 
notation 1 PLHIWAIT Test whether ECB is posted 
4 (4) 2 PLHEFLGS Exception flags: 
Byte 1: 
| Peer PLHNOSPC End of Volume could find 
no more space for creation 
mi ee PLH1ST This is the first request after the data set 
was opened 
oe eee PLHSKPER Skip across the error control interval 
ey ieee PLHSRINV Spanned record is invalid 
ore eee PLHNOADV Don’t advance the PLH 
od ie PLHEODX The EODAD exit was taken 
me PLHINVAL The PLH is invalid 
Gist 1 PLHDSCAN Scan data after read exclusive 
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Placeholder (PLH)—Description and Format 


Offset 


6(6) 


7(7) 


13 (D) 
14 (E) 
15 (F) 
16 (10) 
20 (14) 
24 (18) 
28 (1C) 


32 (20) 


36 (24) 


40 (28) 


41 (29) 


42 (2A) 


43 (2B) 
44 (2C) 
48 (30) 


Bytes and 
Bit Pattern 


+ hb S FS 


> 


Field Name 


PLHRSTRT 


PLHFLG3 
PLHSRBSG 
PLHRAHD 


PLHSLVLD 
PLHBWD 


PLHRVRS 
PLHEOVDF 


PLHAFLGS 
PLHDRLM 
PLHVAMB 
PLHDBDC 


PLHIOSID 
PLHRABWD 


PLHACB 
PLHDSTYP 


PLHRMIN 
PLHFRCNT 
PLHBFRNO 
PLHMRPL 
PLHCRPL 
PLHDSIDA 
PLHCRBA 


PLHJORBA 


PLHJRNLL 


PLHJINRBA 


PLHJCODE 


PLHRCODE 
PLHEOVR 


PLHARDB 
PLHLRECL 


Description 
Byte 2: 
Restart 
Reserved 
Flags: 


Update numbers in RDFs of spanned-record 
segments aren't the same 

Do read-ahead buffering. 

Second level of the index is valid 

Previous request specified backward 
processing 

The I/O chain is reversed 

End of Volume synchronization flag 
Reserved 


Flags: 


A direct request was issued during loading of 
an empty data set 

The AMB that points to the PLH is valid 
The PLH is from the VSAM resource pool 
I/O-Support ID 

IDAO19RA was entered for backward 
processing 

Reserved 


Address of the caller’s ACB 
Data set type: 


Data—X‘01’ 
Index—xX‘02’ 


Read threshold 

Number of free buffers 

Total number of buffers 

Address of the RPL header 

Address of the current RPL 

Address of the DSID (PLHACB field above) 


Current RBA 
Old RBA—to support the JRNAD exit 
routine 


Length of the data—to support the JRNAD 
exit routine 


New RBA—to support the JRNAD exit 


routine 


Entry code—to support the JRNAD exit 
routine. See VSAM Programmer’s Guide for 
a list of entry codes. 


Indicates the previous request type 


End of volume request code—indicates space 
allocation or volume mount 


Reserved 
Address of the current data ARDB 


Length of the record processed during the 
previous request 


J 
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Placeholder (PLH)—Description and Format 


Bytes and 
Offset Bit Pattern Field Name Description 
52 (34) 4 PLHDBUFC Address of the current data BUFC 
56 (38) 4 PLHNBUFC Address of the next read BUFC 
60 (3C) 4 PLHRECP Address of the current record 
64 (40) 4 PLHFSP Address of the first byte of free space within 
the record 
68 (44) 4 PLHRDFP Address of the current RDF 
72 (48) 2 PLHRDFC Replication count for the current RDF 
74 (4A) 2 PLHSRSID Spanned-record segment ID 
76 (4C) 4 PLHDIOB Address of the data IOB 
PLHIIOB Address of the index IOB 
80 (50) 4 PLHARET Return address to the I/O Manager's 
Asynchronous Routine 
84 (54) 24 PLHSAVE1 Six 4-byte register save areas—not 
through to be used by Buffer Management, 
PLHSAVE6 I/O Management, IDADRQ, or IDATJXIT 
108(6C) PLHAMB AMB save area for IDADRQ and IDATJXIT 
112(70) PLHCHAIN Address of the next PLH in the chain 
116 (74) PLHRETO Offset to the current register 14 save area in 
the push-down list (PLHRET1) 
118 (76) 2 Reserved 
120 (78) 44 PLHRET1 Save area (push-down list) for 11 return 
registers (register 14) 
164(A4) 4 PLHASAVE Beginning of save area for I/O 
Management's Asynchronous Routine 
168(A8) Save area for thirteenth return register 
172(AC) Save area for fourteenth return register 
176 (BO) PLHAR14 Address to which the Asynchronous Routine 
is to return 
180 (B4) 4 PLHEOVPT Address of the RBA provided by the End of 
Volume routine 
PLHDDDD RBA of the previous request 
184 (B8) PLHNRBA Next RBA 
188 (BC) PLHIBUFC Address of the index BUFC 
192 (CO) PLHRBUFC Save area for register RBUFC for IDADRA 
and IDATJXIT 
196 (C4) 4 PLHISPLP Address of the IXSPL 
200 (C8) 32 PLHIXSPL Space for one IXSPL 
200 (C8) 4 PLHSSRBA RBA of the sequence-set control interval 
PLHHIREC RBA of the highest record 
204 (CC) 4 PLHIXBFC Address of a BUFC for index search 
208 (DO) 24 
232(E8) 4 PLHWAX Address of the work area for path processing 
PLHXPLH Address of the PLH for the alternate index of 
the base cluster 
236(EC) 4 PLHLLOR Address of the least length of the data record 


that contains all of the record’s key fields 
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Placeholder (PLH)—Description and Format 


Offset 

240(F0) 
242(F2) 
244(F4) 
248(F8) 


252(FC) 
256(100) 
260(104) 


264(108) 


265(109) 
268(10C) 


272(110) 
276(114) 


280(118) 


280(1 18) 


280(118) 
284(11C) 
285(11D) 


286(11E) 
288(120) 


VL 


Bytes and 


Bit Pattern 


2 


2 
4 
4 


28 


eeeM XXXX 


20 


VL 


Field Name 


PLHNOSEG 
PLHSRCSG 
PLHSLRBA 
PLHKEYPT 


PLHRRN 


PLHDRRSC 
PLHPARM1 
PLHR13 


PLHDRMSK 


PLHECB 


PLHERRET 


PLHEND 


PLHEXTEN 


PLHRESRI1 


PLHBMWRK 
PLHBMRDF 


PLHBEUC 
PLHBMSOV 


PLHRDCNT 


PLHBMSV!1 
through 
PLHBMSV5 


PLHKEY 


Description 


Number of segments in a spanned record 
Number of the segment being processed 
RBA of the second level of the index 


Address of the current key 
(PLHKEY at end of PLH entry) 
Previous relative record 
number 


Address of the deferred-request flag byte 
Save area for IDADRQ and IDATJXIT 


Register 13 save area for IDADRQ and I/O 
Management 


Mask to test for resources for a deferred 
request 


Reserved 


Address of event control block for 
cross-region post 


Reserved 


Address to which to return from an error (for 
cross-region post) 


Label for the end of the PLH entry before 
PLHEXTEN and PLHKEY 


Extension to the PLH for processing with 
shared resources (optional): 


Address of a serial resource being held 
Reserved 
Buffer-Management work flags: 


The RBA was found in the buffer pool (for 
SCHBFR macro) 

End of use chain 

Start-over flag 

Reserved 


Save area for AMBRDCNT 


Five 4-byte save areas 
for Buffer Management 


The current key, pointed to by PLHKEYPT 
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RPL—Request Parameter List 


The RPL contains user-request information and error feedback information. 
It also maintains information required by GET and PUT macro instructions. 
The RPL is created by the user with the RPL macro instruction. 


Offset 
0 (0) 
0 (0) 
1 (1) 


2 (2) 


9 (9) 


12 (C) 
12 (C) 


13 (D) 


13 (D) 


Bytes and 


Bit Pattern 


4 
| 


Ls eeonue 
XX XXXX 


3 


Field Name 
RPLIDWD 
RPLID 
RPLSTYP 


RPLREQ 


RPLLEN 
RPLLEN2 


RPLPLHPT 
RPLECB 


RPLWAIT 
RPLPOST 


RPLFDBWD 
RPLSTAT 


RPLCHKI 
RPLEDRQI 


RPLFDBK 


RPLRTNCD 
RPLERREG 


Description 
Identification word of the RPL: 
RPL identifier, X‘00’ 


RPL subtype: 
X‘10’ = VSAM 
X‘20’ = VTAM 


Request type—when the user issues a VSAM 
macro-instruction, register 0 contains one of 
the following request type-codes. When 
VSAM processes the request, the request 
type-code in register 0 is transferred to the 
RPLREQ field (unless the request is CHECK 
or ENDREQ). 


GET request 

PUT request 

CHECK request 
POINT request 
ENDREQ request 
ERASE request 
VERIFY request 

Data preformat request 
Index preformat request 
Force I/O request 
GETIX request 

PUTIX request 

Search buffer request 
Mark buffer request 
Write buffer request 


Length of the RPL 


Address of the PLH 


Address of the external ECB, or an 
internal ECB: 


The event has not yet completed 
The event has completed 
Reserved 


Reserved, if RPLECB is an internal ECB, or 
the address of the external ECB 


Feedback word 
RPL status flags: 


CHECK has been issued 
ENDREQ has been issued 
Reserved 


RPL feedback area (See “Diagnostic Aids”’ 
for a list of RPL return codes and condition 
codes.) 


RPL return code (See “Error Codes”’ 
in ‘‘Diagnostic Aids” section for a 
description of RPL return codes.) 


Normal return 
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Request Parameter List (RPL)—Description and Format 


Offset 


14 (E) 
14 (E) 
15 (F) 
16 (10) 


18 (12) 
20 (14) 
24 (18) 
28 (1C) 


32 (20) 
36 (24) 
36 (24) 
36 (24) 
38 (26) 
40 (28) 
40 (28) 


41 (29) 


Bytes and 
Bit Pattern 


x*04’ 


& YY NY ff & A & bh F&F WN 


—_ 


S 


— 


Field Name 


RPLCNDCD 
RPLCMPON 
RPLERRCD 


RPLKEYLE 
RPLKEYL 


RPLSTRID 
RPLCCHAR 
RPLDACB 
RPLTCBPT 


RPLAREA 
RPLARG 


RPLSAF 
RPLDAF 
RPLOPTCD 
RPLOPT!1 
RPLLOC 
RPLDIR 
RPLSEQ 


RPLSKP 
RPLASY 


RPLKGE 
RPLGEN 
RPLECBSW 
RPLECBIN 


RPLOPT2 


RPLKEY 
RPLADR 
RPLADD 
RPLCNV 


RPLBWD 


RPLLRD 


RPLWAITX 
RPLUPD 
RPLNSP 


Description 


Request not accepted because the RPL 
indicated for this request was active for 
another request 

Logical error 

Physical error 


RPL condition code 
Component issuing the code 
Error code 


Key length 


RPL transaction identifier 
Address of the control character 
Address of the caller’s ACB 


Address of the user’s TCB—this field is 
always zero for a VSAM RPL 


Address of the caller’s record area 
Address of the caller’s search argument 
Address of SETPRT parameter list: 
Source address field 

Destination address field 

Option flags 

Option flag byte 1: 


Locate mode 

Move mode 

Direct-search access 

Sequential access 

Skip sequential processing 
Asynchronous request 
Synchronous request 

Search key greater than or equal 
Search key equal 

Generic key 

Full key 

The RPLECB field contains the 
ECB’s address 


Option flag byte 2: 


Locate the record identified by a key 
Locate the record at the caller-specified 
relative byte address (RBA) 

Locate the control interval at the 
caller-specified RBA 

Process in backward direction 
Process in forward direction 

Locate or retrieve the last 

record in the data set 

Locate, retrieve, or store the 

record identified by the 

user's argument 

Take UPAD exit before WAIT 
Update processing 

Note the string position 
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Request Parameter List (RPL)—Description and Format 


Bytes and 
Offset Bit Pattern 
42 (2A) 1 
i ae 
me lee 
i 
..0. 
Les 
XX. 
.00. 
.O1. 
.10. 
11. 
| 
...0 
43 (2B) 1 
\ 
willie 
gallein tee 
| 
X XXX. 
44 (2C) 4 
48 (30) 4 
52 (34) 4 
56 (38) 4 
60 (3C) 8 
60 (3C) 2 
62 (3E) 1 
1 oe 
XXX XXXX 
63 (3F) 1 
64 (40) 4 
68 (44) 1 
i Ie 
lee 
= Wee 
wd ale 
XX X..X% 
69 (45) 1 
70 (46) 2 
72 (48) 4 


Field Name 


RPLOPT3 


RPLEODS 
RPLSFORM 
RPLBLK 


RPLVFY 
RPLFLD 
RPLFMT 


RPLALIGN 


RPLOPT4 


RPLENDTR 
RPLMKFRM 
RPLPDIC 
RPLICOPY 


RPLNXTRP 
RPLCHAIN 


RPLRLEN 
RPLBUFL 


RPLRBAR 
RPLAIXPC 
RPLAIXID 
RPLAXPKP 


RPLDDDD 
RPLEXTDS 
RPLEXTD!1 


RPLEXSCH 
RPLNEXIT 
RPLEXIT 
RPLNIB 


RPLBRANC 
RPLACTIV 


RPLEMLEN 
RPLERMSA 


Description 
Option flag byte 3: 


End of the user’s output data set 
Spool form on remote 

Block the records 

The records are unblocked 
UCS/FCB verify 

UCS fold 

Format type: 

UCS load 

FCB load 

Reserved 

Reserved 

Align the buffer and notify the operator 
Do not align the FCB buffer loads 


Option flag byte 4: 


3800 end of transmission 
3800 mark form 

PDIC passed 

Pass only one copy of 
the data set 

Reserved 


Address of the next RPL in the chain 


Length of the record 

Length of the user’s buffer 
Reserved 

RBA return location 
Alternate index pointer count 
Alternate index pointer type: 


Relative byte address 
Prime-key pointer 
Reserved 


Reserved 
Relative byte address 


Exit definition flags: 


Ar exit is scheduled 

No exit is specified 
Asynchronous exit 
Argument has a pointer 
to the NIB 

Branch entry to a macro 
Reserved 


CHECK not issued 
Error message length 


Address of the error message area 
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RPLE—RPL Extension 


An RPLE is built and appended to each RPL built for an ISAM Interface user 


when the user’s ISAM program opens a VSAM cluster. The RPLE contains 
the address of the IICB, a register save area, a linkage to other RPLs in the 


J 


ISAM Interface RPL pool, and a pointer to the ISAM DECB. 


Offset 


0 (0) 
4 (4) 


8 (8) 


12 (C) 


16 (10) 


17 (11) 
20 (14) 
24 (18) 


RWA—Reposition Work Area 


The RWA is built and freed by IDAOCO6C and IDAOAOSB. It is used for 


4 
4 


BAN 


Bytes and 
Bit Pattern 


Field Name 
RPLIICB 
RPLDECB 


RPLIITBFR 


RPLRPLPT 


RPLIITSB 


RPLSAVE 
RPLSAVE2 


Description 


Address of the IICB 


Address of the DECB. If the field contains 
zeros, the RPL has not been assigned to a 
DECB (BISAM only) 


Address of the ISAM Interface buffer 
associated with the RPL (the buffer is 
required for locate mode processing, data 
only retrieval, dynamic buffering, and 
BISAM stand-alone write) 


Address of the next RPL in the ISAM 
Interface RPL pool. If the RPL ts the last 
RPL in the pool, this field contains zeros. 


Test-and-set (TS) byte. This field is used to 
indicate the assignment of the RPL toa 
BISAM DECB. 


Reserved 
Register save area 


Register save area 


J 


saving data needed to reposition the user’s data sets at restart. VSAM I/O 
operations necessary during the checkpoint process use the RPL, PLH, and 
BUFC poritions of the work area. It is pointed to by the VRCWA 


(VRCWARWA). 
Bytes and 

Offset Bit Pattern 

0 (0) 1 

1 (1) | 

2 (2) 2 

4 (4) 4 

8 (8) 4 

12 (C) 60 

72 (48) 4 

76 (4C) 4 

80 (50) 4 

84 (54) 76 

160 (AO) 280 


Field Name 
RWAFLAGI 
RWAMBFLG 


RWAPSAV 


RWARGSAV 
RWARBA 
RWABUFC 


RWAEXLST 


Description 

Save area for AMBLFLGI! 
Save area for AMBFLGI 
Reserved 


Address of previous 
Save area 


Reserved 
Register save area 
RBA argument used by GET 


VSAM buffer pointer 
used by GET 


Save area for ACB exit 
list address 


RPL used for GET 


PLH save area 
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SSL—Swap Save List 


UPT—Upgrade Table 


The SSL contains up to 16 entries that identify control blocks that are to be 
chained after Open has otherwise completed successfully. Deferring chaining 
makes it unnecessary to unchain the control blocks should Open fail. 


The SSL is pointed to by OPWA (called the ACB work area). Additional 
SSLs are chained as required. 


Offset 


0 (0) 
1 (1) 
4 (4) 
12 (C) 


16 (10) 
18 (12) 
20 (14) 
20 (14) 


24 (18) 


Bytes and 
Bit Pattern 


1 


> Co WW 


Field Name 


SSLSUBPL 
SSLLENTH 
SSLID 
SSLNXPTR 


SSLACEN 


SSLENTRY 
SSLSWPTR 


SSLSWAP 


Description 


Subpool number of the SSL 
Length of the SSL 
Identifier: ‘bIDASSLb’ 


Address of the next SSL (zero for the last 
SSL in the chain) 


Number of active entries 
Reserved 
Entries for control blocks to be chained: 


Address of the swap word for the 
Compare-and-Swap instruction 


Value to replace original in 
Compare-and-Swap 


The UPT describes the upgrade set of a base cluster. It contains an entry for 
each alternate index in the upgrade set. It is pointed to by the BIB (BIBUPT). 


Bytes and 
Offset Bit Pattern 
UPT Header 
0 (0) 4 
0 (0) u 
1(1) 1 
-XXX XXXX 
2(2) 2 
4 (4) 4 
8 (8) 4 
12 (C) 1 
13 (D) 1 
14 (E) 2 
16 (10) 72 
16 (10) 4 
20 (14) 
24 (18) 1 
25 (19) 1 
26 (1A) 2 


Field Name 


UPTHDR 
UPTID 
UPTFLGO 
UPTPWS 


UPTLEN 
UPTNEW 
UPTOLD 
UPTRSC 
UPTNOENT 


UPTLLEN 


UPTSA 
UPTWORKI1 
UPTLSA 
UPTBEREG 
UPTBERCD 


Description 


Header 
Control block identifier, X‘45’ 
Flags: 


Continue with scan 
Reserved 


Length of the UPT 

Address of the new alternate-index record 
Address of the old alternate-index record 
Resource byte—used to serialize updates 


Number of alternate indexes in the upgrade 
set (and of entries in the UPT) 


Largest sum of key length plus the key’s 
relative position in a data record 


Save area: 

Work area 

Last save area 

RPLERREG value for the base cluster 
RPLERRCD value for the base cluster 


Reserved 
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UPT—Upgrade Table 


Bytes and 
Offset Bit Pattern 
UPT Header 
28 (1C) 4 
32 (20) 56 
UPT Entry 
0 (0) 12 
0 (0) 4 
0 (0) 1 
4 (4) 2 
| epee 
Pere 
belees 
ee eee 
ee 
els 
ofiaier sigs 1 
| Peeeeee 
Pe (ee 
oe eee 
Pe lee 
tiles 
ne XX 
6 (6) 2 
8 (8) 1 
9 (9) 1 
10 (A) Z 


Field Name 


UPTRI14 


UPTRI5 


UPTAXENT 


UPTRPL 
UPTF1LOP 
UPTFLG! 


UPTFILST 
UPTFIATV 
UPTFINUK 


UPTFINOP 
UPTFINRF 
UPTFIKEY 


UPTFIRTY 
UPTFIUPG 


UPTFIBKO 
UPTFILOG 
UPTFIPHY 
UPTFIERA 
UPTF1PNU 


UPTFIPUD 


UPTRKP 


UPTPASS 


UPTLNCDE 
UPTBG 


Description ) 


Address to which IDA019R4 returns after 
I/O is issued for upgrading 


Rest of save area 


Entry for an alternate index in the upgrade 
set: 


Address of the upgrade RPL 
Last operation against the upgrade ACB 
Flags: 


Byte 1: 

This is the last entry in the UPT 

This entry is active for an upgrade operation 
The alternate index can have nonunique keys 
The alternate index is not open 

A no-record-found error has occurred 

The key being processed is: 

0 Old 

1 New 

The last operation is being retried 

The alternate index is being upgraded 


Byte 2: 

An upgrade operation is being undone 
(backed out) 

A logical error has occurred 

A physical error has occurred 

The operation requiring upgrade was 
deletion (ERASE) 

The operation requiring upgrade was 
insertion 


The operation requiring upgrade was update 
Reserved 


Relative alternate-key position in a base 
record 


The number of this upgrade operation (pass 
through the upgrade set) 


Length of key, minus 1 
Length ofRPLAREA field 
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VAT—Valid-AMBL Table 


The VAT is used to check the validity of each AMBL that is built for 
processing a base key-sequenced cluster. It contains the address of each 
AMBL. The first VAT is pointed to by the JSCB (JSCBSHR). 


Offset 
0 (0) 
0 (0) 
1 (1) 
2 (2) 
4 (4) 
8 (8) 


8 (8) 
12 (C) 
16 (10) 


20 (14) 
20 (14) 
21 (15) 
22 (16) 
24 (18) 
28 (1C) 
32 (20) 


33 (21) 
36 (24) 


Bytes and 
Bit Pattern 


4 
1 


1 
2 
4 
8 


Ben 


Field Name 
VATHDR 
VATID 


VATLEN 
VATNEXT 
VATVSRTF 


VATVUSE 
VATVPTR 
VATPAMBL 


VATVC 


VATVRT 


VATENO 


VATNAE 


VATAMBLI 


4x16 VATAMBL 


Description 

Header: 

Control block identifier, X‘11’ 
Reserved 

Length of the VAT 

Address of the next VAT 


Used to update the use count and address of 
the VSAM shared resource table at the same 
time (with the CDS instruction) 


Use count in the VSRT 
Address of the VSRT 


Address of the first AMBL in the primary 
chain 


Used for checking validity of AMBLs 
The number of this VAT on the chain 
Number of entries in this VAT 
Reserved 

Number of active entries in this VAT 
Reserved 


Zero. This field is used by VSAM 
Checkpoint/Restart to identify enhanced 
VSAM 


Reserved 


Addresses of VALID AMBLs 
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VCRT—VSAM Checkpoint/Restart Table 


The VSAM Checkpoint/Restart Table (VCRT) is used by VSAM 
Checkpoint/Restart while processing the alternate-index environment 
introduced with enhanced VSAM. The VCRT contains a count, by entry 
type, of each entry appended to the VCRT. There are four types of VCRT 
entries, as follows: 


1. The first entry type is the VCRT open entry, which points to the user 
and restart AMBL/ACB set to be opened by restart. This entry is sixteen 
bytes in length and contains pointers to the user AMBL, the restart 
AMBL, the user ACB, and the restart ACB. The restart AMBL and ACB 
pointers will be filled in at restart time. 


2. The second entry type is the VCRT Upgrade Entry, containing pointers to 
the user and restart upgrade AMBLs to be processed by restart. This 
eight-byte entry will exist only if the immediate-upgrade set for this data 
set was open at checkpoint time. 


3. The third entry type is the VCRT Upgrade ACB Entry, which contains 
only a pointer to the user ACB to be updated. This four-byte entry exists if 
there are ACBs open at checkpoint time which need not be opened for 
restart processing but must be updated at restart time. 


4. The fourth entry type is the VCRT Index Entry. Eight bytes in length, this 
entry exists only if the base data set is a KSDS open for load-mode 
processing. There will be one index entry for each index level that exists at 
checkpoint time. The index entry contains ICWA and buffer pointers for 
the index level it represents. 


The VCRT is created by VSAM checkpoint and, except in error situations, is 
freed by VS checkpoint and VSAM restart. The following diagram shows the 


format of the VCRT. 
Bytes and 
Offset Bit Pattern Field Name Description 
0 (0) 1 VCRID VCRT ID field 
1 (1) 3 VCRFLAGI VCRT flags 
Vetacaave VCRUPGSW Entry type indicator: 
1=process VCRT upgrade entry 0=process 
VCRT open entry 
Ni, ides VCRLSR LSR specified 
secles, ches VCROUT Output ACB is open 
eX XXXX Reserved (Bytes two and three are also 
reserved.) 
4 (4) 8 VCRIDNM VCRT identification name,, IDAVCRT’ 
12 (C) 4 VCRSIZE VCRT size in bytes 
16 (10) 4 VCRCHAIN Pointer to next VCRT 
20 (14) 2 VCROPNCT Number of VCRT open entries 
22 (16) 2 VCRUPGCT Number of VCRT upgrade entries 
24 (18) 2 VCRUPDCT Number of VCRT update ACB entries 
26 (1A) 2 VCRIDXCT Number of VCRT index entries 
28 (1C) 4 VCRVCRWA Pointer to VSAM restart work area 
(VCRWA) 
32 (20) 4 VCRRBUF Pointer to Restart buffer 
36 (24) 4 VCROPN Pointer to VCRT open entries 
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VCRT—VSAM Checkpoint/Restart Table 


Description 

Pointer to VCRT upgrade entries 
Pointer to VCRT update ACB entries 
Pointer to VCRT index entries 


Pointer to password 


Pointers to the first of each of the following entry types are at offsets 36 (24) through 48 


Bytes and 
Offset Bit Pattern Field Name 
40 (28) 4 VCRUPG 
44 (2C) 4 VCRUPD 
48 (30) 4 VCRIDX 
52 (34) 4 VCRPASSW 
(30) above. 
VCRT Open Entry 


VCRUAMBL 
VCRRAMBL 
VCRUACBP 
VCRRACBP 


Pointer to user AMBL 
Pointer to restart AMBL 
Pointer to user ACB 
Pointer to restart ACB 


VCRT Upgrade Entry (For addressability, this is the same as the 
AMBL portion of the Open Entry) 


VCRT Update ACB Entry 


VCRT Index Entry 


VCRUAMBL 
VCRRAMBL 


VCRUPDPT 


VCRICWA 
VCRBUFPT 


Pointer to user immediate-upgrade AMBL 


Pointer to restart immediate-upgrade AMBL 


Pointer to update ACB 


Pointer toICWA 


Pointer to associated buffer 
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VCRWA—VSAM Checkpoint/Restart Work Area 


The VSAM Checkpoint/Restart Work Area (VCRWA) is created by VSAM 


checkpoint. If an error occurs during VSAM checkpoint processing, it is also 
freed by VSAM checkpoint. If no error occurs, it is freed by VS checkpoint 
during checkpoint processing, and by VSAM restart during restart processing. 


J 


The VCRWA is shared by all loads of VSAM checkpoint restart and is 
therefore saved, in the checkpoint data set, at checkpoint time and restored at 


restart time. 
Bytes and 
Offset Bit Pattern Field Name 
0 (0) | VCRWID 
1 (1) | VCRWFLG 
2 (2) 2 VCRWSIZE 
4 (4) 8 VCRWIDNM 
12 (C) 4 VCRWVSWA 
16 (10) 4 VCRWVCRT 
20 (14) 4 VCRWRWA 
24 (18) 4 VCRWRWAS 
28(1C) 4 VCRWRPL 
32 (20) 4 VCRWPLH 
36 (24) 4 VCRWSHR 
40 (28) 4 VCRWRETI1 
44(2C) 4 VCRWRET2 
48 (30) 4 VCRWRET3 
52 (34) 4 VCRWBASE 
56 (38) 4 VCRWRACB 
60(3C) 4 VCRWACBS 
64 (40) 4 VCRWBOSB 
68 (44) 3 VCRWECB 
69 (47) 1 VCRWCC 
XXXX X.XX 

a VCRWAD 
72 (48) 4 VCRWBUFC 
VCRWMSG - Error message 
76 (4C) 16 VCRWHEBS 
92(5C) 5 
97 (61) 8 VCRWDDNM 
105 (69) 3 
VCRWGLST - GETMAIN list 
108(6C) 4 VCRWRETA 
112(70) 4 VCRWSZ 
116(74) 12 VCRWPARM 
VCRWRSAV  - Register save area header 
128 (80) 4 VCRWRSO1 
132 (84) 4 VCRWRS02 
136 (88) 4 VCRWRS0O3 


Description 
VCRWA ID field 


Reserved 

VCRW size in bytes 

VCRWA identification name, IDAVCRWA 
Pointer to VS work area 

Pointer to current VCRT 

Pointer to VSAM reposition work area 


Size in bytes of checkpoint/restart RWA, 
RPL, and PLH 


Pointer to checkpoint/restart RPL 
Pointer to checkpoint/restart PLH 
JSCBSHR save area 

Register 14 save area one 

Register 14 save area two 

Register 14 save area three 

Save area for IDAOAOSB base register ») 
Pointer to restart ACB core 

Restart ACB core size 

Pointer to second level VSAM Restart 

Restart page-fix ECB 


Page-fix ECB flags 
unused 
Page-fix error indicator 


Pointer to BUFC save area 


Message body and HEB save 
Remainder of message body 
DD name of data set in error 


Remainder of message 


GETMAIN return address 
GETMAIN core size 
GETMAIN parameter list 


Standard save area header 
Standard save area header 


Standard save area header 
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VCRWA—VSAM Checkpoint/Restart Work Area 


Bytes and 
Offset 


Bit Pattern Field Name 


VCRWRSAV - Register save area header 


> 


140 (8C) 
144 (90) 

148 (94) 

152 (98) 

156 (9C) 
160 (AO) 
164 (A4) 
168 (A8) 
172 (AC) 
176 (BO) 
180 (B4) 
184 (B8) 
188 (BC) 
192 (CO) 
196 (C4) 
200 (CB) 
204 (CC) 


bh f£ fh Fk FL FL Ff FL Ff LF fF Lh FH SH LH F 


208 (DO) 
208 (DO) 
208 (DO) 
20C (D4) 
210 (D8) 
214(DC) 


bh fF FL FL HL F 


VCRWRS04 
VCRWREGE 
VCRWREGF 
VCRWREGO 
VCRWREGI 
VCRWREG2 
VCRWREG3 
VCRWREG4 
VCRWREG5 
VCRWREG6 
VCRWREG7 
VCRWREG8 
VCRWREG9 
VCRWREGA 
VCRWREGB 
VCRWREGC 
VCRWBAS2 


VCRWRKPT 
RVATSAVE 
RWORKA 
RWORKB 
RWORKC 
IRBAD 


Description 


Standard save area header 
Register 14 save area 
Register 15 save area 
Register 0 save area 
Register 1 save area 
Register 2 save area 
Register 3 save area 
Register 4 save area 
Register 5 save area 
Register 6 save area 
Register 7 save area 
Register 8 save area 
Register 9 save area 
Register 10 save area 
Register 11 save area 
Register 12 save area 


Save area for second 
base register 


Workarea pointers 
VAT pointer save area 
Work pointer A 

Work pointer B 

Work pointer C 

IRB address 
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VMT—Volume Mount Table 


The VMT identifies and describes volumes to be mounted for a base cluster 
and all clusters associated with it for processing. There is a VMT for each 
device type. The first VMT is pointed to by the BIB (BIBVMT). 


Offset 
0 (0) 
0 (0) 
1 (1) 
2 (2) 
4 (4) 
8 (8) 
10 (A) 
13 (D) 
13 (D) 
14 (E) 
16 (10) 
16 (10) 
20 (14) 


21 (15) 
22 (16) 
28 (1C) 


Bytes and 
Bit Pattern 


-XXX XXXX 


1 


VSRIT—VSAM Shared Resource Table 


The VSRT contains the addresses of buffer pools and PLH pools in the 
resource pool and addresses of various control blocks built during the 
processing of a BLDVRP macro. For local shared resources (LSR), the VSRT 
is pointed to by the VAT (VATVPTR). 


Offset 
0 (0) 
1(1) 
2 (2) 
4 (4) 
12 (C) 


14(E) 


15(F) 


Bytes and 
Bit Pattern 


NM oo WN 


X... XXXX 


XXXX XXXX 


| 


Field Name 
VMTHDR 
VMTID 


VMTLEN 
VMTNXT 
VMTNOVOL 


VMTDEV 
VMTDVOPT 
VMTDVTYP 
VMTVOL 
VMTUSECT 
VMTVFLG! 
VMTOPEN 


VMTVLSER 
VMTUCB 


Field Name 
VSRTBKID 


VSRTLEN 
VSRTID 
VSRTFLGS 


VSRTLSRF 
VSRTIOBF 


VSRTBFRF 


VSRTKL 


VSRTSTRN 


Description 

Header: 

Control block identifier, X*12’ 

Reserved 

Length of the VMT 

Address of the next VMT 

Number of volume entries (7) in the VMT 
Reserved 

Device information: 

Device options 

Device class and type 

Volume entry for a volume to be mounted: 
Use count 

Volume flags: 


The volume is being processed by Open 
Reserved 


Reserved 
The volume’s serial number 


Address of the UCB for the volume 


Description 

Control block identifier, X‘15’ 
Reserved 

Length of the VSRT 

Visual identifier 

Flags: 


Byte 1: 

Local resource pool 

I/O-related control blocks are fixed in real 
storage 

Buffers are fixed in real storage 

Reserved 


Byte 2: 
Reserved 


The maximum key length of the data sets 
that are sharing the resource pool 


The total number of placeholders required 
for all the data sets (specified in BLDVRP) 
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VSRT—VSAM Shared Resource Table 


Offset 
16(10) 
20(14) 
24(18) 
28(1C) 


32 (20) 
36 (24) 
36 (24) 


37 (25) 
40 (28) 


41 (29) 


Bytes and 
Bit Pattern 


4 


WAX—Work Area for Path Processing 


The WAX contains addresses and other information required for processing a 
path. It is pointed to by the PLH (PLHWAX). 


Offset 
0 (0) 
1 (1) 


2 (2) 
4(4) 


6 (6) 
8 (8) 


12 (C) 
16 (10) 
20 (14) 


24 (18) 


28 (1C) 


Bytes and 
Bit Pattern 


> 


Field Name 


VSRTPLHH 
VSRTBUFH 
VSRTCPAH 
VSRTWAH 


VSRTCSL 
VSRTCSLF 


VSRTCSFX 
VSRTCSVS 
VSRTCSBF 
VSRTCSPF 
VSRTCSWS 


VSRTCSPL 
VSRTCSIO 
VSRTCSBH 


VSRTCSSP 
VSRTCSSP 


VSRTCSLN 


Field Name 
WAXID 
WAXFLG1 
WAXSRAB 
WAXPUG 


WAXPS 


WAXLEN 
WAXPL 


WAXXXXX2 


WAXIRPL 


WAXURPL 
WAXRCDA 
WAXXPTR 


WAXEPTR 


WASBPLH 


Description 


Address of the PLH header 
Address of the BUFC header 
Address of the CPA header 


Address of the working storage header 
(WSHD) 


Reserved 
Entries for gotten storage: 
Flags: 


The storage is fixed in real storage 

The storage contains the VSRT 

The storage contains a buffer 

The storage contains the page fix list 
The storage is for a work area (working 
storage) 

The storage contains PLHs 

The storage contains IOBs 

The storage contains a buffer 


Address of the storage 


The number of the subpool the storage is 
located in 


Length of the storage 


Description 
Control block identifier, X‘73’ 
Flags: 


Catalog recovery area built in system storage 
The alternate index in the path is in the 
upgrade set 

The last operation against the path was a 
sequential PUT 

Reserved 


Length of the WAX 


Length of the alternate-index record’s 
pointers to base records 


Reserved 


Address of the inner (““dummy”) RPL that is 
used to gain access to the alternate index 


Address of the user’s RPL 
Address of the alternate-index record 


Address of the current alternate-index 
pointer to a base record 


Address of the byte beyond the last 
alternate-index pointer 


Address of the PLH for the base cluster 
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WAX—Work Area for Path Processing 


Offset 
32 (20) 
36 (24) 
40 (28) 


WSHD—Working Storage Header 


Bytes and 
Bit Pattern 


4 
4 
4 


Field Name 
WAXSRAA 
WAXSRAL 
WAXXXXX3 


Description 
Address of the saved-record area 
Length of the saved-record area 


Reserved 


The WSHD describes up to four blocks of storage used for work areas 
(working storage). It is pointed to by the AMB (AMBWSHD). 


Offset 
0 (0) 
1(1) 


2 (2) 

4 (4) 

4 (4) 

8 (8) 

18 (12) 
20 (14) 
2 4(18) 
28 (1C) 


28 (1C) 
32 (20) 


32 (20) 
32 (20) 


33 (21) 
36 (24) 
40 ( 


42 (2A) 


43 (2B) 


Bytes and 
Bit Pattern 


| 
1 


oXXX XXXX 


| 


Field Name 
WSHDID 
WSHDPOOL 


WSHDLEN 
WSHDNEXT 
WSHDGMTB 
WSHDGMWA 
WSHDNUS 
WSHDGMRA 
WSHDOCHN 
WSHDSLT 


WSHDSAD 
WSHDSGMW 


WSHDSFM 
WSHDSFSP 


WSHDSFLN 
WSHDSONX 
WSHDSBV 


WSHDSFLG 
WSHDSFNO 


WSHDSBM 


Description 
Control block identifier, X*44 


The number of the subpool in which the 
WSHD is located 


Length of the WSHD 

Address of the next WSHD 

GETMAIN resource byte 

GETMAIN work area 

Number of used slots (entries) in the WSHD 
GETMAIN result 

Address of ordered slot chain 


Slot (entry) for each block of working 
storage: 


J 


Address of the storage block 


Work area for the GETMAIN for the storage 
block: 


FREEMAIN field for the DLVRP macro: 


The number of the subpool in which the 
storage block is located 


Length of the storage block 
Address of the next slot on ordered slot chain 


Number of bytes represented by each bit in 
WSHDSBM 


Slot flags: 


The storage block has no bytes available 
Reserved 


Bit mask (each bit indicates whether the 
bytes it represents are used—1, or not—0) 
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CC 


DIAGNOSTIC AIDS 


This chapter provides several aids that can be useful when you are trying to 
diagnose 


difficulties with VSAM modules. These aids include: 


e A description of the cross-reference information published on microfiche 
cards. 


e A list of messages issued by VSAM, cross-referenced to enable you to 
detect the module causing the message to be issued. 


e A list of function codes that appear in messages to indicate the operation 
being performed when an error occurred. 


e A list of VSAM macro instructions and their functions. 


e A catalog debug aid that provides dumps that can be selected and activated 
upon termination of a catalog management request. 


e A description of a system-provided service, GTF, used by VSAM, how 
VSAM requests this service, and what this service provides in the way of 
VSAM APAR information. 


e A description of the Catalog Communications Area’s register save area. 
e A list of return codes and error codes. 


e A description of the control blocks and control block interrelationships of 
the Virtual-Storage Manager. 


Additional aids can be found in other parts of the book and in the program 
listings. These include: 


e Register contents on entry to a module, which are under “INPUT’”’ in the 
module prologues. 


e Use of registers and equated names for registers, which can be found under 
“NOTES” in the module prologues. 


e Error codes, which are under ““EXIT-ERROR’”’ in the module prologues. 


e A list of modules, their external procedure names, their component, and 
their associated method of operation diagrams, which is in the ‘‘“Module 
Directory.”’ 


e A list of external procedure names and their modules, which is in the 
“External Procedure Directory.”’ 


e A definition of terms and abbreviations used in this book, and in the 
VSAM listings, which is in the ‘“‘Glossary.”’ 
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Microfiche Cross-Reference Aids 


OS/VS1 VSAM Cross Reference contains valuable information that you 
should be aware of. Two types of cross-reference information are available: 


e Symbolic-name usage table: lists each symbolic name that appears in the 
VSAM code listings, lists each module that refers to the symbolic name, 
and specifies how each module refers to the symbolic name. 


e Macro-instruction usage table: lists each macro instruction that is issued in 
VSAM listings, specifies the total number of times the macro instruction is 
issued, lists each module that issues the macro instruction, and specifies the 
number of times the module issues the rhacro instruction. 


How To Read the Symbolic-Name Usage Table 


OS/VS1 VSAM Cross Reference contains the symbolic-name usage table, 
or Symbol Where Used Report, for VSAM listings. Three kinds of 
information are available from the table, as shown in Figure 74: 


¢ A list of symbolic names—this includes field names, symbolic address 
names, return code names, constant/value names, flag-bit names, etc.—in 
alphanumeric order from top to bottom on the page. 


Note: In the lower-right corner of each page, the lowest and highest name 
for the page is shown. 


¢ A list of modules that refer to each symbolic name, in alphanumeric order 
from left to right across the page. 


¢« A code indicating how each module refers to the symbolic name: 


W-WRITE 


R-READ 


C—COMPARE 


The data field or bit value was modified by at least one 
line of code in this module. If the module contains a 
statement: 


A=B 


then the module’s use of ‘A’ is to modify it (‘A’ appears 
to the left of an equate sign in a statement that is not 
an ‘IF’ statement.) 


The data field or value was referred tp by at least one 
line of code in this module. If the module contains a 
statement: 


A=B 


then the module’s use of ‘B’ is to refer to it, using it to 
modify ‘A’ (‘B’ appears to the right of an equate sign in 
any type of statement). 


The data field or value was compared against another 
value. If the module contains a statement: 


IF A = B, THEN ... 


then the module’s use of ‘A’ is to compare it to ‘B’ (‘A’ 
appears to the left of an equate sign in an ‘IF’ 
statement). Note that the module’s use of ‘B’ is to refer 
to it, not to compare it. 


Other codes are explained in the ‘‘Access Codes” at the bottom of each page 


in the usage table. 
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LLL LT ITE EE eI CE SE TES a Ee a a LT TT I STE SSS RS SIC A TCT 


DATE: 


SYMBOL 


01/15/77 


MODULE 


(EXTERNAL SYMBOLS) 


MODULE 


ACCESS 


MODULE 


ACCESS 


me ee ee ee ae a a a a a a a ee a a a i ee eee ee ee ee a ee ee 


ACBBUFSP 
ACBCAT 
ACBCBMWA 
ACBCRNCK 
ACBCRNRE 
ACBDDNM 


ACBDEB 
ACBDIR 
ACBDORGA 
ACBDOSID 
ACBDTFID 
ACBERFL 
ACBERFLG 
ACBEXFG 
ACBEXLST 
ACBID 
ACBIDVAL 
ACBIN 
ACBINFL 
ACBINRTN 
ACBKEY 
ACBLEN 
ACBLENG 


IEAVNP1A 
IDACAT11 
IDAQ19C1 
IGCOA05B 
IGCOBO5B 
IDACAT 11 
IGGOCLAD 
IDACAT 13 
IEAVNP1A 
IDACAT 11 
IGGOCLAD 
IGGOCLAD 
IFGO191X 
IFGO191Y 
IDACAT11 
IGCOCO6C 
IDACAT11 
IGGOCLAD 
IDAOQ19C 1 
IEAVNP1A 
IGCOBO5B 
IDA019¢C1 
IDACB2 

IDACAT11 


SYMBOL WHERE USED REPORT --- OS/VS2 RELEASE 1.7 VSAMPAGE 3 
ACCESS MODULE ACCESS MODULE ACCESS MODULE ACCESS 
R 
W IDACAT12 W IGGOCLAD W IGGOCLAE W 
DRW 
Cc 
Cc Iccocoec Cc 
W IDAO19C1 W IEAVNP1B IEAVNP11 W 
W IGGOCLAE W IGGOCLBG WwW 
R IEAVNPIA W IGCOBO5B 
Cc IFGO191X W 
W IDAO19C1 WwW IGCOCO6C IGGOCLAD W 
W IGGOCLAE W IGGOCLBG WwW 
R IGGOCLAE R IGGOCLBG 
W 
W IFGO200N W IGCOAO5B RWC IGGOCLAE C 
W IDAO19¢C1 IGGOCLAD W IGGOCLBG 
RW 
W IDAO19C1 WC IGCOCO06C IGGOCLAD WwW 
R IGGOCLAE IGGOCLBG 
W IFGO191X IGGOCLBG 
R IFGO191X 
R 
W IFGO191X W IGGOCLBG W 
M 
W IDAOQ19C1 WwW IGGOCLAD W IGGOCLAE W 


IFGO191X 


IGGOCLAE 


IGGOCLAE 


IGGOCLBG 


IGCOAO5B 


IGGOCLBG 


IGGOCLBG 


we ee ee ee ee eee ee ae a i a i a a a a a a ee en ae a a a i a a ae ee a a ee ee ee ee a ee ee ee ee ee ee ee eee ee ee 


ACCESS CODES: D=DEFINITION, R=READ, W=WRITE, C=COMPARE, E=EQUATE OPERAND, M=MACRO, A=ABSOLUTE, 


Figure 74. Symbolic-Name Usage Table 


P=PARAMETER 


How To Read the Macro-Instruction Usage Table 


OS/VS1 VSAM Cross Reference contains the macro-instruction usage 
table, or Macro Where Used Report for VSAM listings. Three kinds of 
information are available, as shown in Figure 75: 


e A list of macro-instruction names in alphanumeric order from top to 
bottom. 


e A list of the modules that issue each macro-instruction, in alphanumeric 
order from left to right across the page. 


e The total number of times all VSAM modules issued the macro-instruction, 
and the number of times each module in the list issued the 


macro-instruction. 
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dRaa eee eeaaae essen eee renee re eec eee ee es ee eee eee eee ee nee ae een eee eee eee eee cere scence cere eeee renee neers cee eres Tce aE ES 


DATE: 01/15/77 


MACRO 


wee ee wee 


ABEND 
ABPCALL 
ACB 
ACBX 
ADDRESS 
AMCBS 


AMOREGN 
ASM1 
BLDL 
CALL 
CARD 
CATGODSP 
CATGOGC 1 
CATGOSEQ 
CCAASCIK 
CCACD1 
CCACPE2 
CCACPE3 
CCACPE4 
CCACPES5 
CCACPE6 
CCACPE7 
CCARABB 
CCARABFL 


TOTAL # 


MACRO WHERE USED REPORT 


MODULE 


# 


IEAVNP11 
IEAVNP12 
IGCOAO5B 
IEAVNP11 
IGGOCLAP 


IDACAT 11 
IEAVNP 12 


IGGMCDCL 
LEAVNP1A 
IEAVNP 11 
IDACB2 

IGGOCLAP 
IGGOCLAP 
IGGOCLAP 
IGGOCLAP 
IGGOCLAP 
IGGOCLAQ 
IGGOCLAP 
IGGOCLAP 
IGGOCLAP 
IGGOCLAP 
IGGOCLAP 
IGGOCLAP 
IGGOCLAP 
IGGOCLAP 


IDACAT 12 1 
IGGMCDCL 1 


IEAVNP11 1 


IGGOCLAQ 4 


--- OS/VS2 RELEASE 1.7 VSAM PAGE] 
MODULE # MODULE # MODULE # MODULE # 
IDACAT13 1 IEAVNP1A 1 IEAVNP1B 1 IEAVNP11 1 


me ee ee a oe we ee a a a a ee a a a a a a i a a eee ee ee ee a a a ee ee te ee ee eee ew ee ee a ee ee ee ee ee ee eee 


Figure 75. Macro-Instruction Usage Table 


MACRO ENTRIES: ABEND - CCARABFL 


Messages 


Messages IDA001 through IDA025 are macro-instruction messages and refer to an incorrectly 
coded macro instruction. 


Message 
Number 


IDAO001 
IDA002 
IDA003 
IDA004 
IDA005 
IDA006 
IDA007 
IDA008 
IDA009 


IDA010 
IDAO11 
IDA018 


IDA019 
IDA020 


Message 
Text 


INVALID POSITIONAL PARAMETER, xxx - IGNORED 

xxx KEYWORD REQUIRED - NOT SPECIFIED 

INVALID VALUE, yyy, SPECIFIED FOR xxx KEYWORD 

xxx KEYWORD NOT VALID FOR EXECUTE FORM - IGNORED 
INVALID OR DUPLICATE SUBLIST ITEM FOR xxx KEYWORD, yyy 
xxx VALUE, yyy, NOT VALID FOR LIST FORM 

LOGIC ERROR IN MACRO xxx 

INCOMPATIBLE SUBLIST ITEMS, yyy AND zzz FOR xxx KEYWORD 


xxx CONTROL BLOCK KEYWORDS SPECIFIED - ONLY ONE 
ALLOWED 


EXIT ADDRESS REQUIRED FOR xxx KEYWORD - NOT SPECIFIED 
xxx ISNOT A VALID yyy KEYWORD - IGNORED 


VTAM KEYWORD xxx SPECIFIED WITHOUT SPECIFYING AM = 
VTAM 


KEYWORDS xxx AND yyy ARE INCOMPATIBLE 


VTAM SUBLIST ITEM xxx SPECIFIED FOR yyy KEYWORD 
WITHOUT SPECIFYING AM = VTAM 
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Message 
Number 


IDA021 
IDA022 
IDA024 
IDA025 
Message 
Number 


IECOOIA 
IECO03E 


IECO14E 
IECO70I 


IECI01A 
IECI11E 
IEC113A 


IEC114E 
IEC115I 


IEC1161 


IEC1301 
IEC1611 


IEC2511 


IEC2521 


IEC301A 
TEC3311 


Message 
Text 


xxx AND yyy KEYWORDS MUST BE SPECIFIED TOGETHER BUT 


ONE IS MISSING 


CONFLICTING SUBLIST ITEMS WERE SPECIFIED FOR xxx 


KEYWORD 


xxx, A VSAM KEYWORD SPECIFIED FOR A NONVSAM CONTROL 


BLOCK 


www,xxx, yyy CONFLICTING SUBPARAMETERS IN zzz KEYWORD, 


www ASSUMED 


Message 
Text 


M ddd,ser, jjj,sss,dsn 


R ddd,ser,jjj,sss, 
[,SPACE=PRM] ,dsn 


D dddd 


rrr[(sfi )|-ccc, jjj,sss,ddn, 
ddd, vol,cin,dsn,cat 


M ddd,ser, jjj,sss,dsn 
D, ddd,ser 
ENTER PASSWORD FOR DATA SET 


D ddd [ddn-n] 
INVALID PASSWORD 


REENTER 


ddn - DD STATEMENT MISSING 


rrr[(sfi )]-ccc,jjj,sss,ddn, 
ddd, vol,cin,dsn, cat 


rrr[(sfi)\-ccc, jjj,sss,ddn, 
ddd, vol,cin,dsn,cat 


rrr{(sfi))-ccc,jjj,sss,ddn, 
ddd, vol,cln,dsn,cat 


S JOB xxxxxxxx DSNAME 
ccc-rrr, jjj, sss, ff ff, mmm 


Detected 
by 


IDA0192V 
IDA0192V 


IDA0192V 


IDA0192C 
IDA0192D 
IDA0192S 
IDA0192V 
IDA0557A 
IFGO551F 


IGGOCLBL 
IGGOCLBL 


IGGOCLBG 
IGGOCLBM 
IGGOCLB6 


IGGOCLBL 


IGGOCLBG 
IGGOCLBM 
IGGOCLB6 


IGGOCLBG 
IGGOCLBM 
IGGOCLB6 


IFGO191X 


IDA0192C 
IDA0192D 
IDA0192S 
IDA0192V 
IDA0192Z 
IDA0192A 
IFG0193A 


IDA0192C 
IDA0192D 
IDA0192S 
IDA0192V 
IDA0200T 
IFG0200V 


IDA0192C 
IDA0192D 
IDA0192V 
IDA0231T 
IGC0002C 


IGGOCLBM 
IGGOCLAG 


Issued 
by 


IDA0192V 
IDA0192V 


IDA0192V 
IDA0192P 


IDA0192V 
IDA0192V 


IDA0192P 


IDA0192P 


IDA0192P 


IGGOCLAF 
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Message Message Detected Issued 
Number Text by by 
(IGGPIORA) 
(IGGPEMSG) 
IEC332I SSF ASSPF..] IGGOCLAG IGGOCLAF 
(IGGPIORA) 
(IGGPEMSG) 
IEC3331 teee,xx, ddd, iii IGGOCLAG IGGOCLAF 
(IGGPIORA) 
(IGGPEMIO) 
IEC338I1 IGGOCLC9I, VALIDITY CHECK FAILED 
ON CATALOG PARAMETER LIST 
STORAGE 
IEC3391 IGGOCLC9, INSUFFICIENT STORAGE 
FOR VSAM CATALOG COMMUNICATION 
AREA 
IEF175I1 AMP KEYWORD xxxxxxxx DUPLICATE IEFNB902 
OR CONFLICTING PARM STEP NOT 
EXECUTED 
IEF447I AMP KEYWORD annnnnnon IS IEFNB902 
INVALID STEP WAS NOT EXECUTED 
IEF448I1 AMP KEYWORD annnnnnn VALUE IEFNB902 
xxxxxx IS TOO LARGE STEP 
NOT EXECUTED 
IEF449] AMP KEYWORD annnnnnn REQUIRES — IEFNB902 
A DECIMAL VALUE STEP 
NOT EXECUTED 
IHJOOOI CHKPT jjj (ddn) NOT TAKEN (xxx) 
IHJ0071 RESTART NOT SUCCESSFUL 
FOR jij (xxx [,cuu]) 
IHJO091 ERROR ON ddn IDAOA05B 


Function Codes for VSAM Open, Close, and EOV Messages 


When an error occurs during open, close, or EOV processing for a VSAM 
data set, the message that is issued will contain a field, ccc, that contains a 
function code. The following lists these function codes and ties each to the 
module that detected the error and the operation being performed when the 
error was detected. 


Function 
Code 


¥ 


Module that 


Detected 
Error 


IDA0192C 
IDA0192C 


IDA0192C 
IDA0192C 
IDA0192C 
IDA0192C 
IDA0192C 
IDA0192C 
IDA0192C 
IDA0192C 


Operation Being Performed When 
Error Was Detected 


Initialize for catalog interface processing. 


Determine which data sets are associated with dsname or DD 
statement, determine catalog and check password. 


Determine data set attributes. 

Get volume information. 

Update ‘open’ indicator in catalog. 

Update catalog when data set is being closed. 
Retrieve volume timestamp. 

Record management catalog update. 

Update preformat indicator in catalog. 


Retrieve 44-byte clustei uame. 
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Function 
Code 


Module that 
Detected 
Error 


IDA0192C 
IDA0192V 
IDA0192V 
IDA1092V 
IDA0192V 
IDA0192S 
IDA0192S 
IDA0192D 
IDA0192D 
IDA0192D 
IDA0192D 
IDA0192Z 
IDA0192Z 
IDA0192Z 
IDA0192Z 
IDA0192Y 
IDA0192B 
IDA0192B 
IDA0192B 
IDA0192B 
IDA1092W 
IDA0192W 
IFG0193A 
IDA0192A 
IDA0192A 
IDA0192F 
IDA0192B 
IDA0192F 
IDA0192A 


IDA1092F 
IDA1092F 
IDA0192F 
IDA0192A 
IDA0192A 
IDA0192A 
IFG0192B 


IFG0200V 
IDA0200T 
IDA0200T 
IDA0200T 


Operation Being Performed When 
Error Was Detected 


Retrieve 44-byte component name. 


Initialize for mounting and verify volume. 


Check volume timestamp. 

Handle messages. 

Mount volume. 

Initialize for SMF processing. 

Build SMF record. 

Initialize for staging. 

Build UCB list. 

Build list for ACQUIRE/RELINQUISH (stage/destage). 
Issue ACQUIRE or RELINQUISH. 
Initialize for building control blocks. 
Determine number of buffers needed. 
Build buffers. 

Build control blocks. 

Build string blocks. 

Module initialization. 

Locate data-set attributes and check them for validity. 
Volume processing. 

Preformat extent. 

Initialize for building channel program. 
Build channel program area. 

Read JFCB. 

Initialize for VSAM open processing. 
Verify ACB. 

Fix control blocks in real storage. 
Allow subtasks to share data set. 
Mount and verify volumes. 


Determine whether to connect base cluster to an existing 
structure or generate a new structure. 


Open base cluster. 

Open alternate index in upgrade set. 

Open alternate index in path. 

Build a dummy DEB. 

Terminate VSAM Open processing. 

Clean up after an error in Open processing. 


Error processing for VSAM ACB processed on a system not 
generated for VSAM. 


Read JFCB. 
Initialize for VSAM close processing. 
Complete deferred write requests. 


Close path. 
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Function 
Code 


105 
106 


107 
108 
110 
111 
112 
113 
114 
115 
150 
151 
153 
154 
155 
156 
157 
158 
159 
160 
161 
200 
202 
202 
203 
204 
205 
206 
207 
208 
209 


Module that 
Detected 
Error 


IDA0200T 
IDA0200T 


IDA0200T 
IDA0200T 
IDA0200B 
IDA0200B 
IDA0200B 
IDA0200B 
IDA0200B 
IDA0200B 
IGC0002C 
IDA0231T 
IDA0231T 
IDA0231T 

IDA0231T 

IDA0231T 

IDA0231B 
IDA0231B 
IDA0231B 
IDA0231B 
IDA0231B 
IFGO551F 

IDA0557A 
IDA0557A 
IDA0557A 
IDA0557A 
IDA0557A 
IDA0557A 
IDA0557A 
IDA0557A 
IDA0557A 


Operation Being Performed When 
Error Was Detected 


Close base cluster. ) 


Close sphere (close upgrade alternate indexes and free 
storage). 


Close upgrade set. 

Process volume mount table. 

Module initialization. 

Check validity of AMBLs and DEBs. 

SMF processing. 

Update statistics and RBA information in the catalog. 
Free storage for control blocks. 

Write a buffer. 

Read JFCB. 

Initialize for VSAM CLOSE (TYPE=T) processing. 
Complete deferred write requests. 

Close (TYPE=T) path. 

Close (TYPE=T) base cluster. 

Close (TYPE=T) upgrade set. 

Module initialization. 

Check validity of AMBLs and DEBs. 

Update statistics and RBA information. 

SMF processing. 

Write a buffer. 

Read JFCB. 

Initialize for VSAM end-of-volume processing. 
Locate and mount volume. 

Allocate space. 

Switch volumes. 

Build control blocks. 

Update SMF record. 

Preformat extent. 

Record management, catalog update. 


Reset control blocks. 
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Macro Instructions 


The following tables list VSAM and OS/VS macro instructions and explain 
what they do. Each module that issues the macro instruction is also listed. The 
macro instructions are divided into those that define control blocks and data 
area (mapping macro instructions) and those that issue executable code 
(action macro instructions). 


Mapping Macro Instructions 


The following table lists macro instructions that define the format of control 
blocks and data areas used by VSAM modules. 


Macro Instructions That Define Data Areas 


Macro 
Instruction 
AMCBS 
CIRB 

CLCL 

CVT 
F4DSCB 
IDAAIR 
IDAAMB 
IDAAMBL 
IDAAMDSB 
IDAARDB 
IDABFK 
IDABIB 
IDABLPRM 
IDABSPH 
IDABUFC 
IDACBTAB 
IDACIDF 
IDACLWRK 
IDACMB 
IDACPA 
IDACSL 
IDACTREC 


IDADIWA 
IDADSL 
IDAEDB 
IDAELEM 


IDAEQUS 


IDAERMSG 
IDAERRCD 


Description 


Maps the VSAM catalog vectors table (AMCBS) 

Maps the CIRB control block 

Maps the CLCL control block 

Maps the communications vector table (CVT) 

Maps the Format-4 Data Set Control Block (DSCB) 

Maps the alternate-index record 

Maps the Access Method Block (AMB) 

Maps the Access Method Block List (AMBL) 

Maps the Access Method Data Set Statistics Control Block (AMDSB) 
Maps the Address Range Definition Block (ARDB) 

Maps the buffer control set 

Maps the Base Information Block (BIB) 

Maps the Resource Pool Parameter List (BLPRM) 

Maps the Buffer Subpool Header for shared resources (BSPH) 
Maps the Buffer Control Block (BUFC) 

Maps the tables used by the Control Block Manipulation routine 
Maps the Control-Interval Descriptor Field (CIDF) 

Maps the Close Work Area (CLW) 

Maps the Cluster Management Block (CMB) 

Maps the Channel Program Area (CPA) 

Maps the Core Save List (CSL) 


Maps the work area built when the VSAM catalog management 
routines issue OPEN (SVC 19), CLOSE (SVC 20), or SVC 55 (calls 
End of Volume processing). 


Maps the Data Insert Work Area (DIWA) 
Maps the DEB Save List (DSL) 
Maps the Extent Definition Block (EDB) 


Maps the Control Block Manipulation routine’s element argument 
control entry 


Defines the equates for the ISAM Interface: SY NAD—Message-Build 
routine 


Maps the ISAM Interface: SYNAD Message format 
Lists the VSAM Open/Close ACB Error Codes 
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Macro Instructions That Define Data Areas 


Macro 
Instruction 


IDAESL 
IDAFOREC 


IDAGENC 
IDAHEB 
IDAICWA 
IDAIDXCB 
IDAIICB 
IDAITREG 


IDAIMWA 
IDAIOB 
IDAIOSCN 
IDAIRD 
IDAIXSPL 
IDALPMB 
IDAMODC 
IDAOPWRK 
IDAPDPRM 


IDAPLH 
IDARDF 
IDAREGS 
IDARMRCD 
IDARPLE 
IDASHOW 
IDASSL 
IDATEST 
IDAUPT 
IDAVAT 
IDAVMT 
IDAVSRT 
IDAVUCBL 
IDAVVOLL 


IDAWAX 
IDAWSHD 
IECDIOSB 
IECDSECS 
IECSDSLI1 
IEESMCA 


Description 
Maps the Enqueue Save List (ESL) - 


Maps the work area for VSAM Open/Close/EOV Modules 
IDAFOREC issues IDAPDPRM, IEFJFCBN, and IEFJFCBX. 
Maps the GENCB header argument control entry 

Maps the Header Element Block (HEB) 

Maps the Index Create Work Area (ICWA) 

Lists the VSAM control-block-identifier codes 

Maps the ISAM-Interface Control Block (IICB) 

Defines the ISAM Interface Register usage 


IDAIIREG issues IDAIICB, IDARPLE, IFGRPL, IHADCB, and 
IHADCBDF. 


Maps the Index Modification Work Area (IMWA) 

Maps the VSAM IOB extension 

Maps the VSAM Open/Close/EOV commonly-used declarations 

Defines the index record 

Maps the Index Search Parameter List (IXSPL) 

Maps the Logical-to-Physical Mapping Block (LPMB) 

Maps the MODCB header argument control entry 

Maps the Open Work Area (OPW) 

Maps the VSAM Open/Close/EOV problem determination parameter : 
list S 
Maps the Placeholder (PLH) , 
Maps the Record Definition Field (RDF) 

Defines register usage for all record management modules 

Lists the record management return codes 

Maps the ISAM-Interface Request Parameter List Extension (RPLE) 

Maps the SHOWCEB header argument control entry 

Maps the Swap Save List (SSL) 

Maps the TESTCB header argument control entry 

Maps the Upgrade Table (UPT) for upgrading alternate indexes 

Maps the Valid-AMBL table (VAT) 

Maps the Volume Mount Table (VMT) 

Maps the VSAM Shared Resource Table (VSRT) 

Maps the VSAM Open/EOV: Volume Mount and Verify UCB list 


Maps the VSAM Open/EOV: Volume Mount and Verify volume serial 
number list 


Maps the Work Area for Path Processing (WAX) 
Maps the Working Storage Header (WSHD) 
Maps the I/O supervisor control block 

Maps the DSECTS 


Maps the SDSL1 
Maps the SMCA J 
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Macro Instructions That Define Data Areas 


Macro 
Instruction 


IEFJESCT 
IEFJFCBN 
IEFJFCBX 
IEFJMR 
IEFPCCB 
IEFQMIOP 
IEFTCT 
IEFTIOT1 
IEFUCBOB 
IEZCTGCV 
IEZCTGFL 
IEZCTGFV 
IEZCTGPL 
IEZCTGVL 
IEZCTGWA 
IEZDEB 
IEZIOB 
IEZJSCB 
IFGACB 
IFGEXLST 
IFGRPL 
IGGCAXWA 
IGGCCA 
IGGMCDCL 


IGGMCMDM 


IGGMCMWA 
IGGMCTRC 
IGGMDRWA 
IGGMF4WA 
IGGMGVO 
IGGMSAWA 
IGGMUPDE 


IGGMVEDC 
IGGMZLOC 


Description 


Maps the JESCT 

Maps the Job File Control Block (JFCB) 

Maps the Job File Control Block (JFCB) 

Maps the JMR 

Maps the Private Catalog Control Block (PCCB) 

Maps the QMIOP 

Maps the TCT 

Maps the Task Input/Output Table (TIOT) 

Maps the OS/VS Unit Control Block (UCB) 

Maps the VSAM Catalog Control Volume List (CTGCV) 
Maps the VSAM Catalog Field Parameter List (CTGFL) 
Maps the VSAM Catalog Field Vector Table (CTGFV) 
Maps the VSAM Catatalog Parameter List (CTGPL) 
Maps the VSAM Catalog Volume List (CTGVL) 

Maps the VSAM Catalog Scheduler Work Area (CTGWA) 
Maps the OS/VS Data Extent Block (DEB) 

Maps the OS/VS Input/Output Block (IOB) 

Maps the OS/VS Job Step Control Block (JSCB) 

Maps the Access Method Control Block (ACB) 

Maps the Exit List (EXLST) 

Maps the Request Parameter List (RPL) 

Maps the VSAM Catalog Auxiliary Work Area (CAXWA) 
Maps the VSAM Catalog Communications Area (CCA) 


Contains the commonly used control block formats and constants for 
VSAM catalog management modules 


IGGMCDCL issues AMCBS, AMOREGN, COMREGN, CVT, 
IEZCTGCV, IEZCTGFL, IEZCTGFV, IEZCTGPL, IEZCTGWA, 
IFGACB, IGGCAXWA, IGGCCA, IGGMCTRC, and IKJTCB. 


Maps the VSAM catalog management commonly-used record 
structures 


Maps the VSAM catalog management services work area 

Lists the catalog management return codes 

Maps the VSAM catalog DSCB read-in work area 

Maps the VSAM Catalog Management format-4 DSCB work area 
Maps the volume information set of fields 

Maps the VSAM Catalog Management: Suballocate work area 


Defines the commonly-used declarations for VSAM Catalog 
Management: Update-Extend modules 


IGGMUPDE issues IDAAMDSB, IGGMCDCL, IGGMCMDM,, 
IGGMSAWA, and IGGMVEDC. 


Maps the Volume Catalog Record 


Defines the commonly-used declarations for VSAM Catalog 
Management: Suballocate modules 
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Macro Instructions That Define Data Areas 


Macro 


Instruction Description 2 
IHADCB Maps the OS/VS Data Set Control Block (DCB) 

IHADCBDF Maps the OS/VS Data Set Control Block (DCB) 

IHADECB Maps the OS/VS Data Extent Control Block (DECB) 

IHARB Maps the OS/VS Request Block (RB) 

IKJPSCB Maps the OS/VS PSCB 

IKJTCB Maps the Task Control Block (TCB) 

SGIDA401 Lists the VSAM SYSGEN global definitions 

XCTLTABL Maps the OS/VS Transfer Control (XCTL) table 


Action Macro Instructions 


This table lists the macro instructions that generate executable code. 


Macro Instructions That Generate Executable Code 


Macro 

Instruction Description 

ABEND Abnormal termination (OS/VS macro instruction) 

ADDREC Calls IGGPPAD to write a new record into the catalog 

BLDVRP Builds a VSAM resource pool (for shared resources) 

CALLSF xxxx Transfers control to procedure IGGPxxxx 

CALL EXIT Returns control to the caller of the procedure 

CATLG Loads the address of the catalog parameter list (CTGPL) into register 1 2 
and issues SVC 26 

CATPROB Problem determination 

CLOSE VSAM CLOSE: Disconnects a user from a VSAM data set 

COMB Generates combination name entries in the VSAM combination name 
index table 

DEBCHK Checks the validity of the DEB 

DELETE (Same as OS/VS DELETE macro instruction) 

DELREC Calls IGGPPDE to erase a catalog record 

DEQ (Same as OS/VS DEQ macro instruction) 

DEVTYPE Determines the direct-access device type 

DICT Generates entries in the VSAM catalog field name dictionary 

DLVRP Deletes a VSAM resource pool (for shared resources) 

DOM Deletes operator message (same as OS/VS DOM macro instruction) 

ENDREQ Terminates a VSAM record processing request (such as GET or PUT) 

ENQ (Same as OS/VS ENQ macro instruction) 

ERASE Deletes a VSAM record 

EXCP (Same as OS/VS EXCP macro instruction) 

EXCPVR (Same as OS/VS EXCPVR macro instruction) 

FREEMAIN Releases virtual storage obtained by a GETMAIN 

GENCB Generates a VSAM control block (ACB, EXLST, RPL) 

GET Retrieves a record from a data set on a direct-access device J 
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Macro Instructions That Generate Executable Code 


Macro 
Instruction 


GETIX 
GETMAIN 
GETREC 
GTRACE 


IDABFR 
IDACALL 


IDACB1 


IDACB2 


IDAERMAC 


IDAEXITR 


IDAGMAIN 
IDAPATCH 
IDARST14 
IDASVR14 
IECRES 
IGGMEND 
IGGMODUL 
IGGMPROC 
LOAD 
MODCB 
MODESET 
MRKBFR 
OBTAIN 
OPEN 
PGFIX 


PGFREE 
POINT 
POST 

PUT 
PUTIX 
RESERVE 
RETURN 
SCHBFR 
SHOWCAT 


Description 


Retrieves a control interval from the index of a key-sequenced data set 
Obtains virtual storage for a temporary work area 
Calls IGGPGET to retrieve a catalog record 


Calls the Generalized Trace Facility (GTF) to copy VSAM control 
blocks 


Sets the RBA and/or status in the buffer control block (BUFC) 


Transfers control from procedure A to procedure B and allows 
procedure B to return control to procedure A at the instruction 
following the IDACALL instruction-expansion 


Transforms operands for Control Block Manipulation macro 
instructions (GENCB, MODCB, SHOWCEB, and TESTCB) 


Scans keywords and generates code for Control Block Manipulation 
macro instructions 


Prints MNOTES for Control Block Manipulation macro instruction 
user-programmer errors 


Transfers control from VSAM modules to a user’s exit routine and 
allows the user exit routine to return control to the VSAM module at 
the instruction following the IDAEXITR instruction-expansion 


IDAEXITR issues DELETE, IDARST14, IDASVR14, and LOAD. 
Gets virtual storage for VSAM Open/Close/EOV 

Generates maintenance space 

Puts the return address in register 14 

Saves register 14 in the placeholder (PLH) push-down list 
Transfers control to the OS/VS Resident routine 

Generates code at the end of VSAM Catalog Management modules 
Generates header code for VSAM Catalog Management modules 
Generates header code for VSAM Catalog Management procedures 
(Same as OS/VS LOAD macro instruction) 

Modifies a VSAM control block (ACB, EXLST, RPL) 

(Same as OS/VS MODESET macro instruction) 

Marks a buffer in a VSAM resource pool 

(Same as OS/VS OBTAIN macro instruction) 

Connects a user’s program to a VSAM data set 


““Fixes’’ a page of virtual storage so that it appears (to OS/VS) as real 
storage 


‘Frees’ a ‘‘fixed”’ page of virtual storage 

Identifies a starting point ina VSAM data set 

(Same as OS/VS POST macro instruction) 

Writes a record into a VSAM data set 

Writes a control interval in the index of a key-sequential data set 
(Same as OS/VS RESERVE macro instruction) 

(Same as OS/VS RETURN macro instruction) 

Searches for a control interval in a VSAM resource pool 


Displays information from a VSAM catalog 
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Macro Instructions That Generate Executable Code 


Macro 

Instruction Description 

SHOWCB Displays information from a VSAM control block 

SMFWTM Writes the SMF message into the SMF data set 

SYNCH (Same as ISAM SYNCH macro instruction) 

TESTCB Tests information in a VSAM control block (ACB, EXCST, RPL) 

TIME Obtains the correct time from the OS/VS system time-of-day clock 

VERIFY Gives control to Record Management to check the end-of-data 
indicators for Checkpoint/Restart or for Access Method Services 
VERIFY command 

WAIT (Same as OS/VS WAIT macro instruction) 

WRTBFR Writes a buffer from a VSAM resource pool 

WTO Writes a message to the operator (no reply) 

WTOR Writes a message to the operator (a reply is expected) 

XCTL Transfers control (same as OS/VS XCTL macro instruction) 


Note: The following macros are VSAM user’s macros and are described in 
detail in the OS/VS Virtual Storage Access Method (VSAM) Programmer’s 
Guide: 


CLOSE 
ENDREQ 
ERASE 
GENCB 
GET 
MODCB 
OPEN 
POINT 
PUT 
SHOWCB 
TESTCB 


The following VSAM user’s macros are described in detail in OS/VS Virtual 
Storage Access Method (VSAM) Options for Advanced Applications: 


BLDVRP 
DLVRP 
GETIX 
MRKBFR 
PUTIX 
SCHBFR 
SHOWCAT 
WRTBFR 


636 OS/VS2 SVS Independent Component: Virtual Storage Access Method (VSAM) Logic 


C 


Using the CVT’s VSAM Debug Switches 


The CVTAMFF field (displacement = X‘108’) in the CVT (Communications 
Vector Table) allows the PSR (Programming Systems Representative) to run 
a program using VSAM that contains an error and, when the error occurs; to 
save certain VSAM control blocks and work areas that would otherwise be 
destroyed. 


Getting A Dump of Open, Close, and End-of-Volume Work Areas 


The messages that the problem determination routine (IDA0192P) issues for 
open, close, and end of volume (the function codes for these messages follow) 
may not be sufficient to find the problem. 


In such a case, you can obtain an ABEND dump by turning on (setting to ‘1’) 
a bit in the CVT and rerunning the job in error. Use the CPU manual 
procedure AM (alter real storage) to set bit 4 of the first byte of CVTAMFF 
to ‘1’. The CVT’s location is stored in fixed-storage location X‘10’. Add 
X‘0108’ to the CVT’s address, or set this byte to X‘08’. 


CVT 
CVTAMFF 


When an error occurs with this bit turned on, the problem determination 
module (IDA0192P) issues its messages and also issues an ABEND with a 
user code of 888. 


The contents of the general registers (0O—15) of the module that called 
IDA0192A (the same module identified by the function code) can be found 
at the address calculated by adding X‘0140’ to the contents of register 4 at 
entry to ABEND. 


The caller’s register 13 points to its save area, which precedes its work area. 
By following the save area chaining address from save area to save area, you 
can locate the work area of each module in open, close, or end of volume that 
processed before the error occurred. 


Each module in open, close, and end of volume pairs its save area with its 
work area. Work areas have no general format, but vary from module to 
module. 


Using the VSAM Catalog Debug Aid 


The VSAM debug catalog aid allows the PSR to exercise certain options when 
VSAM catalog management requests terminate. The options are trapping and 
issuing a problem determination message. Either one or both can be selected, 
and you can specify that they be activated upon termination of (1) all 
requests, (2) only those requests that generate a nonzero return code in 
CCACD1, (3) only those requests that generate an abnormal return code in 
CCACD1, or (4) only those requests that generate a specific return code in 
CCACD1. 
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Defining Debug Aid Options 


Debug aid options are defined by storing values and setting bits within the 

CVTAMFF field in the CVT. The PSR can use the CPU manual procedure . 
AM (alter main storage) to modify the CVTAMFF field. (Note, however, = 
that bits 0-3 of CVTAMFF must not be changed.) 


You accomplish debug activity by storing a nonzero value (X‘01’—X‘FF’) 
into CVTAMFF-+1 (the CVT’s location + X‘109’) and X‘O7FE’ (a BR 14 
instruction) into bytes 3 and 4 of CVTAMFF (CVT’s location + X‘10A’). 
The nonzero value you store determines the scope of the debug activity, as 


follows: 

X‘01’ Exercise options upon termination of all requests 

X‘02’ Exercise options only when the catalog return code is nonzero 

x‘03’ Exercise options only when the catalog return code is not a normal 
return code (0, 8, 36, 40, 44, 76, and 140, and reason codes 40, 188, and 
240 are considered normal) 

X‘04’-X‘FF’ Exercise options only when the catalog return code equals the value 


stored. 


Selecting Debug Options 


Each option selected will be exercised only when the catalog termination 
routine determines that the catalog return code (in CCACD1) falls within the 
defined scope. The trap option is activated by setting a hardware address 
stop, a DSS ‘AT’, or a VM ADSTOP at the location of the BR 14 instruction 
contained in the low-order two bytes of CVTAMFF (the CVT’s location + 
X‘10A‘). The catalog termination routine executes a BALR R14, R15 
instruction to pass control to the BR 14 instruction. 


Register contents at the time of the debug trap are: J 
Register Contents 
0 CPL bytes 0, 1, 2, and 16 (the type of catalog management request can be derived 
from the information contained in these bytes) 
1 Contents of CCAPROB (module ID, error code, and return code) 
11 Pointer to CCA 
14 Return address 
15 Address of trap instruction 


To cause determination message IEC331I to be issued, set bit 5 (X‘04’) of 
CVTAMFF (the CVT’s location + X‘108’) to 1. 


CVT 


CVTAMFF 
108 109 10A 


Scope of 


debug activity 


1 = Issue message 
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Generalized Trace Facility 


The Generalized Trace Facility (GTF) can be used to record information 
about VSAM processing at the time of an error. If GTF is active in the 
OS/VS system, GTF is used to trace VSAM control blocks when there is an 
error. 


GTF is used to record the contents of the ACB, AMBL, AMBs, AMDSBs, 
and TIOT entry for the data set being processed when the error occurred. 


To format and print GTF records, use the IMDPRDMP service aid with 
“USR=(FFF,FF5)”’ specified in the EDIT statement. 


Two types of traces are available to help in debugging VSAM 
Open/Close /EOV problems: 


e The error trace routine traces VSAM control blocks when an error is 
detected. The optional work area trace traces the Open/Close/EOV work 
area WIG table prefix and the current entry in the WTG table at entry to 
and exit from the VSAM Open/Close/EOV modules. 


e The work area trace is requested by specifying AMP=““TRACE”’. This is 
the same trace that is obtained for nonVSAM Open/Close/EOV 
processing when DCB=DIAGNS=TRACE is specified in the JCL. (For 
details on the AMP and DCB JCL parameters and options, see OS/VS 
JCL Reference. 


Both traces require that GTF be operating in external mode while the job to 
be traced is running. In addition, the operator must respond with 
‘““TRACE=USR” when the GTF trace message “SPECIFY TRACE 
OPTIONS” appears at the operator’s console. 


Additional information on GTF and IMDPRDMfP is contained in the OS/VS 
Service Aids. 


Catalog Communication Area Register Save Area 


A catalog communication area (CCA) is built for every call to VSAM catalog 
management. The CCA contains a register save area (CCAREGS) that 
allows the PSR (programming systems representative) to follow the flow of 
control from one catalog management external procedure to another, through 
each procedure called to process the request. 


The contents of registers 12, 13, and 14 are put into CCAREGS whenever a 
catalog management procedure is entered. The current value of register 13 is 
the address of the latest entry in CCAREGS. If an external catalog 
management procedure is entered from another catalog management 
procedure, three words are saved as follows: 


e the first word contains the contents of register 12—the calling procedure’s 
base address, 


e the second word contains the contents of register 13—a pointer to the 
previous 12-byte entry in the register save area (CCAREGS), and 


e the third word contains the contents of register 14—the return address in 
the calling procedure. 


Immediately after registers 12, 13, and 14 are saved (at register 13 + 12 
(decimal)), register 12 is updated to contain the called procedure’s base 
address. Register 13’s value is increased by 12, so that it points to the latest 
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entry in CCAREGS. While a catalog management procedure is processing, 
register 11 contains a pointer to the beginning of the CCA. 


Note that backward movement is not recorded in the trace table. For 
example, if procedure B returns to procedure A, the return is not shown in the 
register save area. 


Error Codes 


VSAM sets error codes in the RPL, the ACB, and the CCA. Codes in the 
RPL and the ACB are paired with codes in register 15. Error codes set in the 
RPL are listed and explained under ‘“‘Record Management Error Codes.”’ 
Those set in the ACB are listed and explained under “‘Open, Close and 
End-of-Volume Error Codes.”’ And those set in the CCA, are listed and 
explained under “Catalog Management Error Codes.”’ 


VSAM sets a pair of codes in registers 15 and 0 for control block 
manipulation macros. These are listed and explained under ‘‘Control Block 
Manipulation Error Codes.” 


Record Management Error Codes 


After a request macro is issued or a CHECK or ENDREQ macro is issued, 
register 15 contains a return code. 


After an asynchronous request for access to a data set, VSAM indicates in 
register 15 whether the request was accepted, as follows: 

Reg 15 Condition 

0 (0) Request was accepted. 


4 (4) Request was not accepted because the request parameter list indicated by the Jy 
request (RPL=address) was active for another request. 


After a synchronous request, or a CHECK or ENDREOQ macro, register 15 
indicates whether the request was completed successfully, as follows: 

Reg 15 Condition 

0 (0) Request completed successfully. 


4 (4) Request was not accepted because the request parameter list indicated by the 
request (RPL=address) was active for another request. 


8 (8) Logical error; specific error is indicated in the feedback field in the RPL. 
12(C) Physical error; specific error is indicated in the feedback field in the RPL. 


Paired with the 0, 8, and 12 indicators in register 15 are return codes in the 
feedback field of the request parameter list. 


The feedback return codes for the 0 indicator in register 15, which doesn’t 
cause VSAM to exit to an exit routine, are: 


FDBK 
Code Condition 


0 (0) Request completed successfully. 


4 (4) Request completed successfully. For retrieval, VSAM mounted another volume 
to locate the record; for storage, VSAM allocated additional space or mounted 
another volume. 


8 (8) For GET requests, indicates a duplicate key follows; for PUT requests, indicates 
a duplicate key was created in an alternate index with the nonunique attribute. 


12(C) (Shared resources only.) A buffer needs to be written. ) 
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See the discussions below of the LERAD exit routine for the logical-error 
return codes and of the SYNAD exit routine for the physical-error return 
codes. 


Function Codes for Logical and Physical Errors 


When a logical or physical error occurs during processing that involves 
alternate indexes, VSAM provides a code in the RPLCMPON field that 
indicates whether the base cluster, its alternate index, or its upgrade set was 
being processed and whether upgrading was okay or might have been 
incorrect because of the error: 


Code What Was Being Processed Status of Upgrading 


0 (0) Base cluster Okay 
1 (1) Base cluster Might be incorrect 
2 (2) Alternate index Okay 
3 (3) Alternate index Might be incorrect 
4 (4) Upgrade set Okay 
5 (5) Upgrade set Might be incorrect 


LERAD Exit Routine: Logical Error Analysis 


When a LERAD routine is provided, it gets control for logical errors, and 
register 15 doesn’t contain 8, but contains the entry address of the LERAD 
routine. 


The contents of the registers when VSAM exits to the LERAD routine are: 


Reg Contents 

0 Unpredictable. 

1 Address of the request parameter list that contains the feedback field the routine 
should examine. The register must contain this address if the exit routine returns 
to VSAM. 

2-13 Same as when the request macro was issued. Register 13, by convention, contains 


the address of the processing program’s 72-byte save area, which may not be used 
as a save area by the LERAD routine if the routine returns control to VSAM. 


14 Return address to VSAM. 


15 Entry address to the LERAD routine. The register doesn’t contain the 
logical-error indicator. 


If a logical error occurs and no LERAD routine is provided (or the LERAD 
exit is inactive), VSAM returns control to the processing program following 
the last executed instruction. Register 15 indicates a logical error (8), and the 
feedback field in the request parameter list contains a code identifying the 
error. Register 1 points to the request parameter list. 
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The following list gives the logical-error return codes in the feedback field and 
explains what each one means. 


FDBK 
Code 


4 (4) 


8 (8) 


12 (C) 


16 (10) 


20 (14) 


24 (18) 


28 (1C) 


32 (20) 


36 (24) 


40 (28) 


44 (2C) 


64 (40) 


68 (44) 


72 (48) 


Condition 


End of data set encountered (during sequential retrieval). Either no EODAD 
routine is provided, or one is provided and it returned to VSAM and the 
processing program issued another GET. 


Detected by: IDAOI9RA, IDA0O19RD, IDAOI9RR, IDAOISRY, IDAOI9R2, 
IDA019R4, IDA019R8 


Attempt was made to store a record with a duplicate key. 
Detected by: IDA019RA, IDA019RQ, IDA019RX, IDA019R4 


Attempt was made to store a record out of ascending key sequence; record may 
also have a duplicate key. 


Detected by: IDA0I9RA, IDA0O19RR, IDA019RX, IDAO19R4 
Record not found. 
Detected by:IDA019RA, IDA0OI9RR, IDAO1ORY 


Record and its control interval already held in exclusive control by another 
requester. 


Detected by: IDA01I9RF, IDAOIORY, IDA019R2, IDAO19R8 
Record resides on a volume that can’t be mounted. 
Detected by: IDAO19RW, IDAOI9RY, IDAO19R2, IDA019RS 


Data set cannot be extended because VSAM can’t allocate additional 
direct-access storage space. Either there is not enough space left in the data 
space to allocate the secondary allocation request or an attempt was made to 
increase the size of a data set during processing with SHROPT=4 and 
DISP=SHR. 


Detected by: IDAO19R5 


An RBA was specified that doesn’t give the address of any data record in the the 
data set. 


Detected by: IDA0O19RA, IDA019R8 


Key ranges were specified for the data set when it was defined, but no range was 
specified that includes the record to be inserted. 


Detected by: IDA019RM 

Insufficient virtual storage in the address space to complete the request. 
Detected by: IDA0I9RG, IDA019RU, IDA01I9RX 

Work area not large enough for the data record (GET with OPTCD=MVE). 
Detected by: IDA01I9RR, IDAO19RT, IDAOI9SRY, IDA019R4, IDAO19R8 


As many requests are active as the number specified in the STRNO parameter 
of the ACB macro; therefore, another request cannot be activated. 


Detected by: IDA019RU, IDA0OI9RX, IDAO19R1 


Attempt was made to use a type of processing (output or control-interval 
processing) that was not specified when the data set was opened. 


Detected by: IDA019RQ, IDA019R4, IDA019R8 


A keyed request for access was made to an entry-sequenced data set, or a 
GETIX or PUTIX was issued to an empty entry-sequenced or relative record 
data set. 


Detected by: IDA019R1, IDA019R8 
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FDBK 
Code 


76 (4C) 


80 (50) 


84 (54) 


88 (58) 


92 (SC) 


96 (60) 


100 (64) 


104 (68) 


108 (6C) 


112 (70) 


116 (74) 


132-(84) 


136 (88) 


Condition 


An addressed or control-interval PUT was issued to add a record toa 
key-sequenced data set, or a control-interval PUT was issued to a relative record 
data set. 


Detected by: IDA019R1, IDA019R8 


An ERASE request was issued for access to an entry-sequenced data set. 
Detected by: IDA019RL, IDA019RX, IDA019R8 


OPTCD=LOC was specified for a PUT request or in a request parameter list in 
a chain of request parameter lists. 


Detected by: IDA019RQ, IDAO19R1, IDA019R4, IDA019R8 


A sequential GET or PUT request was issued without VSAM having been 
positioned for it, a change was made from addressed access to keyed access 
without VSAM having been positioned for keyed sequential retrieval, or an 
illegal switch between forward and backward processing was attempted. 


Detected by: IDA019RQ, IDAO19RR, IDA019R4, IDA0I9R8 


A PUT for update or an ERASE was issued without a previous GET for update, 
or a PUTIX was issued without a previous GETIX. 


Detected by: IDA019RQ, IDA019RX, IDA019R4, IDA019R8 

Attempt was made to change a key during an update. 

Detected by: IDAO19RL, IDAOI9RX 

Attempt was made to change the length of a record during an addressed update. 
Detected by: IDA019RL, IDA0N1I9RQ 

The RPL options are either invalid or conflicting in one of the following ways: 

¢ SKP was specified and either KEY wasn’t specified or BWD was specified 

« BWD was specified for CNV processing 

« FWD and LRD were specified 

e Neither ADR, CNV, nor KEY was specified in the RPL 


¢ WRTBFR, MRKBFR, or SCHBFR was issued, but either TRANSID was 
greater than 31 or a shared-resources option wasn't specified 


« ICI processing was specified, but a request other than a GET or a PUT was 
issued 


Detected by: IDAI09RA, IDA019RR, IDAO19RY, IDAO19RX, IDAOI9SRI, 
IDA019R4, IDA019R8 


RECLEN specified was larger than the maximum allowed, equal to 0, smaller 
than the sum of the length and the displacement of the key field, or not equal to 
record (slot) length specified for a relative record data set. 


Detected by: IDA019RL, IDA019RQ, IDA019RU, IDA019R4, IDA019R8 
KEYLEN specified was too large or equal to 0. 

Detected by: IDA019R1 

A GET, POINT, ERASE, direct PUT, skip sequential PUT, or PUT with 


OPTCD=UPD not permitted during initial data-set loading (that is, for storing 
records in the data set the first time it’s opened). 


Detected by: IDA0O1I9RR, IDA019R4, IDA019R8 

An attempt was made in locate mode to retrieve a spanned record. 

Detected by: IDAO19RT 

An addressed GET was issued for a spanned record in a key-sequenced data set. 
Detected by: IDA019RT 


Diagnostic Aids 643 


FDBK 
Code Condition 


140 (8C) Inconsistent spanned-record segments. 

Detected by: IDAOI9R4 J 
144 (90) Invalid pointer in an alternate index (no associated base record). 

Detected by IDAO1I9RX 
148 (94) The maximum number of pointers in the alternate index has been exceeded. 

Detected by: IDA019RU 


152 (98) (Shared resources only.) Not enough buffers are available to process the 
request. 


Detected by: IDA1O09RY 

192 (CO) Invalid relative record number. 
Detected by: IDA019RQ, IDAOI9RR 

196 (C4) An addressed request was issued to a relative record data set. 
Detected by: IDAO19R1 

200 (C8) Addressed or control-interval access was attempted by way of a path. 
Detected by: IDAOI9RX 

204 (CC) PUT-insert requests are not allowed in backward mode. 
Detected by: IDAO19RQ, IDAO19R4 


SYNAD Exit Routine: Physical Error Analysis 


When a SYNAD routine is provided, it gets control for physical errors, and 
register 15 doesn’t contain 12, but contains the entry address of the SYNAD 
routine. 


The contents of the registers when VSAM exits to the SYNAD routine are: Jd 
Reg Contents 
0 Unpredictable. 


1 Address of the request parameter list that contains the feedback field the routine 
should examine and the address of the message area, if any. The register must 
contain this address if the exit routine returns to VSAM. 


2-13 Same as when the request macro was issued. Register 13, by convention, contains 
the address of the processing program’s 72-byte save area, which may not be used 
by the SYNAD routine if it returns control to VSAM. 


14 Return address to VSAM. 


15 Entry address to the SYNAD routine. The register doesn’t contain the 
physical-error indicator. 


If a physical error occurs and no SYNAD routine is provided (or the SYNAD 
exit is inactive), VSAM returns control to the processing program following 
the last executable instruction. Register 15 indicates a physical error (12), and 
the feedback field in the request parameter list contains a code identifying the 
error; the message area contains more details about the error. Register 1 
points to the request parameter list. 
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The physical-error return codes in the feedback field, and what each one 
indicates, are: 


FDBK 
Code Condition 


4 (4) Read error occurred for a data component. 

8 (8) Read error occurred for the index set of an index component. 
12(C) Read error occurred for the sequence set of an index component. 
16(10) Write error occurred for a data component. 

20 (14) Write error occurred for the index set of an index component. 
24(18) Write error occurred for one sequence set of an index component. 


All physical errors are detected by IDAQI9RS. 


Figure 76 gives the format of a physical-error message. The format and some 
of the contents of the message are purposely similar to the format and 
contents of the SYNADAF message, which is described in OS/VS Data 
Management Macro Instructions. 
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Field 


Message 
Length 


Message 
Length - 4 


Address of 
I/O Buffer 


Bytes 


0-1 
2-3 


4-5 


6-7 


8-11 


Length 


Discussion 


Binary value of 128 
Unused (0) 


Binary value of 124 (provided for compatibility 
with SYNADAF message) 


Unused (0) 


The I/O buffer associated with the data in 
relation to which the error occurred 


The rest of the message is in printable format: 


Date 


Time 


RBA 


Data-Set 
Type 


Volume Serial 
Number 


Job Name 


Step Name 


Unit 


Device Type 


ddname 


Channel 
Command 


12-16 
17 


18-25 


26 
27-34 


35 
36—41 


42 


43-48 


49 
50~57 
58 
59-66 
67 
68-70 


71 
72-73 


74 
75-82 


83 


84-89 


90 


1 


YYDDD (year and day) 
Comma (,) 


HHMMSSTH (hour, minute, second, and tenths 
and hundredths of a second) 


Comma (,) 

Relative byte address of the record in relation to 
which the error occurred. 

Comma (,) 


“DATA” or “INDEX” 
Comma (,) 


Volume serial number of the volume in relation 
to which the error occurred 


Comma (,) al 
Name of the job in which error occurred 

Comma (,) 

Name of the job step in which error occurred 

Comma (,) 


The unit, CUU (channel and unit), in relation to 
which the error occurred 


Comma (,) 


The type of device in relation to which the error 
occurred (always DA for direct access) 


Comma (,) 


The ddname of the DD statement defining the 
data set in relation to which the error occurred 


Comma (,) 


The channel command that occasioned the error 
in the first two bytes, followed by ‘‘- OP”’ 


Comma (,) 


Figure 76 (Part 1 of 2). Format of Physical-Error Messages 
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Field Bytes Length Discussion 


Message 91-105 15 Messages are divided according to ECB 
condition codes. 
xX‘47— 

“INCORR LENGTH” 
‘““UNIT EXCEPTION” 
‘“*PROGRAM CHECK”’ 
““PROTECTION CHK” 
““CHAN DATA CHK”’ 
“CHAN CTRL CHK” 
“INTFCE CTRL CHK” 
““CHAINING CHK” 
“UNIT CHECK” 


If the type of unit check can be determined, 
this message is replaced by one of the 
following: 

““CMD REJECT” 

“INT REQ” 

“BUS OUT CK”’ 

‘““EQP CHECK” 

“DATA CHECK” 

“OVER RUN” 

“TRACK COND CK” 

““SEEK CHECK” 

““COUNT DATA CHK’”’ 

“TRACK OVERRUN’”’ 

“CYLINDER END” 

“INVALID SEQ” 

““NO RECORD FOUND” 

‘““FILE PROTECT” 

“MISSING A.M.” 

““OVERFL INCP”’ 


X‘48'—‘PURGED REQUEST” 
X‘4F’—“‘R.HA.RO. ERROR” 


For any other ECB completion 
code— ‘UNKNOWN COND.” 


106 | Comma (,) 

Physical 

Direct-Access 

Address 107-120 14 BBCCHHR (bin, cylinder, head, and record) 
121 1 Comma (,) 

Access Method 122-127 6 “VSAM” 


Figure 76 (Part 2 of 2). Format of Physical-Error Messages 


Open, Close, and End-of-Volume Error Codes 


(For EOV) 

Error Code Set 

in Register 15 Meaning of Error Code 

0 (0) Successful 

4 (4) The requested volume could not be mounted 

8 (8) The requested amount of space could not be allocated 
12 (C) The IOB could not be locked 

16 (10) The VSAM catalog could not be updated 


All End-of-Volume errors are detected by IDAO557A. 
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(For OPEN/CLOSE/TCLOSE) 


Error Code Set 


in ACBERFLG | 
Field of ACB Meaning of Error Code 


0 (0) 


4 (4) 


96 (60) 


100 (64) 


104 (68) 


108 (6C) 


116 (74) 


128 (80) 
132 (84) 


136 (88) 


144 (90) 


148 (94) 


152 (98) 


160 (AO) 


When register 15 contains 0, all data sets were opened or closed 
successfully. 


When register 15 contains 8, either VSAM is processing the ACB for 
some other request, or DDNAME was not specified in the ACB. 


Warning message: the ACB is already opened (and the user issued 
OPEN), or the ACB is already closed (and the user issued CLOSE or 
TCLOSE). 


Warning message: an unusable data set was opened for input. 
Detected by: IDA0192B 


Warning message: Open encountered an empty alternate index that is 
part of an upgrade set. 


Detected by: IDA0192B 


The timestamp for the volume does not match the timestamp in the 
volume catalog record. (This might mean the volume is not accurately 
described by its catalog record.) 


Detected by: IDA0192A 


The timestamp for the index is less than the timestamp for the data set. 
(This could occur if the data set was updated without the index being 
open.) 


Detected by: IDA0192B 

The last request to close this data set was not completed successfully. 
Detected by: IDA0192B 

DDNAME not found in TIOT. 

An I/O error was detected while the system was reading the JFCB. 
Detected by: IDA0192F, IFGO200V 


Not enough storage was available for work areas, buffers, or control 
blocks. 


Detected by: IDA0192A, IDA0192B, IDA0192C, IDA0192F, 
IDA0192W, IDA0192Y, IDA0192Z, IDA0200B, IDA0220T, 
IDA0231B, IDA0231T 


An I/O error occurred while reading or writing a catalog record. A 
return code was set by a VSAM catalog management routine. 


Detected by: IDA0192C 


The catalog entry for the data set being opened or closed was not 
found. 


Detected by: IDA0192C 


The data set being opened is protected by a password, and the VSAM 
Open routine was unable to validate the password. 


Detected by: IDA0192C 


The buffer space specified was not consistent with the buffer 
requirements of the data set; or the ACB indicated keyed access, but 
the data set is not a key-sequenced data set; or the device type specified 
in the DD statement is not consistent with the device type indicated in 
the catalog entry for the data set; or user buffering is specified in the 
ACB’s MACRF field and control-interval processing should be 
specified, but is not. Detected by: IDA0192A, IDA0192B, IDA0192C, 
IDA0192Z 
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J 


(For OPEN/CLOSE/TCLOSE) 


Error Code Set 
in ACBERFLG 


Field of ACB Meaning of Error Code 


164 (A4) 


168 (A8) 


176 (BO) 


180 (B4) 


184 (B8) 


188 (BC) 


192(CO) 


196 (C4) 


200 (C8) 


208 (DO) 


212 (D4) 


216 (D8) 


220 (DC) 


224 (EO) 


228 (E4) 


232 (E8) 


The system detected an I/O error while reading the volume label and 
format-4 DSCB. 


Detected by: IDA0192F 


The Open routine was unable to get the resource the system requested 
for the data set being opened. The resource was being used by another 
task in the system. 


Detected by: IDA0192B 


The Open routine was unable to fix in real storage the access-method 
control blocks for the data set being opened. 


Detected by: IDA0192F 


The requested VSAM master or user catalog does not exist or is not 
open. 


Detected by: IDA0192C 
An I/O error occurred during I/O processing. 


Detected by: IDA0192B, IDA0200B, IDA0200T, IDA0231B, 
IDA0231T 


The data set indicated by the access-method control block is not of the 
type that may be specified by an access-method control block. 


Detected by: IDA0192Z,IDA0200B,IDA0231B 

An unusable data set was opened for output. 

Detected by: IDA0192B 

Access to data was requested by way of an empty path. 
Detected by: IDA0192B | 
The volume is unusable. 

Detected by: IDA0192F 

The ACB MACRF specified GSR. 

Detected by: IDA0192A 


The ACB MACRF specified LSR, but the data set requires create 
processing. 


Detected by: IDA0192B 


The ACB MACRF specified LSR, but the key length of the data set 
exceeds the maximum key length specified in BLDVRP. 


Detected by: IDA0192B 


The ACB MACREF specified LSR, but the data set’s control-interval size 
exceeds the size of the largest buffer specified in BLDVRP. 


Detected by: IDA0192Z 


The ACB MACREF specified ICI, but the data set requires create 
processing. 


Detected by: IDA0192B 


The ACB MACRF specified LSR, but the VSAM shared resource table 
doesn't exist. 


Detected by: IDA0192A 


Reset was specified for a nonreusable data set, but the data set is 
empty. 


Detected by: IDA0192C 
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(For OPEN/CLOSE/TCLOSE) 


Error Code Set . 
in ACBERFLG } 
Field of ACB Meaning of Error Code 

236 (EC) A stage or destage error occurred. 


Detected by: IDA0192D 


240 (FO) Format-4 DSCB and catalog time-stamp verification failed during 
volume mounting for output processing. 


Detected by: IDA0192F 


244(F4) The volume that contains the catalog recovery area wasn’t 
mounted and verified for output processing. 


Detected by: IDA0192F 


Catalog Management Error Codes 


Catalog mamagement sets error and reason codes in the CCAPROB field of 
the CCA (Catalog Communications Area). (For a description of the CCA, 
see “VSAM Control Block Descriptions”’ in the ‘““Data Areas” section of this 
publication.) CCAPROB includes an identification of the catalog 
management module that set the code (CCAMODID), a reason code 
(CCAREASN), and a return code (CCACD1), which appears in register 15. 
Complete explanations of the error and return codes, together with the 
appropriate programmer responses, are given in the description of message 
IDC30091 in OS/VS Message Library: VS2 System Messages. Brief 
descriptions of the return codes are given below: 


Return Code ) 
Set in CCA’s Symbolic 
CCAPROB Field Name Meaning of Return Code 
0 (0) RCS Operation completed successfully. 
4 (4) RCCAT An error occurred while performing open/close 
processing for a VSAM catalog or catalog recovery 
area. 
8 (8) RCENT Entry does not exist, if action is one that locates an 


entry; entry already exists, if action is one that adds an 
entry to a catalog. 


20 (14) RCINSP Not enough space is available in the catalog data set. 
Another extent cannot be obtained because there is no 
more space on the volume in which the catalog resides 
or the maximum number of extents has been reached. 


24 (18) RCIOL Permanent read error in VSAM catalog. 

28 (1C) RCIONL Permanent I/O error in VSAM catalog. 

32 (20) RCINCPL Error was detected in the catalog parameter list 
(CTGPL). 

36 (24) RCDSNF Data set was not found. 

40 (28) RCVLSZ Volume list or work area is too small—the required 
length value is returned in the feedback field. 

44 (2C) RCVLSM Work area is too small; system is unable to return 
required size. 

48 (30) RCINFUNC Operation is not a valid one. 

52 (34) RCIOU I/O error was detected on a user volume. An attempt to ) 
modify the VTOC of the volume on which a 
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Return Code 
Set in CCA’s 
CCAPROB Field 


56 (38) 
60 (3C) 
64 (40) 


68 (44) 
72 (48) 


76 (4C) 


80 (50) 


84 (54) 
88 (58) 
92 (5C) 
94 (SE) 


96 (60) 


98 (62) 


102 (66) 


106 (6A) 
108 (6C) 
112 (70) 


116 (74) 
120 (78) 


124 (7C) 
128 (80) 
132 (84) 
136 (88) 
140 (8C) 
144 (90) 
148 (94) 
152 (98) 
156 (9C) 
160 (AO) 


164 (A4) 
168 (A8) 


Symbolic 
Name 


RCSEC 
RCINENT 
RCNAME 


RCNOSP 
RCNUNIT 


RCNUNIT 


RCRELOP 


RCDATE 
RCCRAOP 
RCDSEXT 
RCOBTAIN 


RCSPANCK 


RCRENAME 


RCSCRTCH 


RCNTFMT4 
RCINFNAM 
RCINFPL 


RCCATBAL 
RCSYSFLD 


RCINCI 
RCBLKVCK 
RCINPTR 
RCMISPAR 
RCINCNPM 
RCINENTN 


RCVOLOWN 


RCDNECAT 
RCNOSPSA 
RCVNDSPD 


RCINSSWA 
RCINVDTY 


Meaning of Return Code 


user-specified data set is being defined or modified 
failed because of a read or write error. 


Password is incorrect. 
Catalog record type is invalid. 


Data set or index catalog record associated with the 
cluster or alternate index catalog record was not found. 


No space is available on a user volume. 

Unit is not available for mounting user volume or 
volume not mounted. 

Unit is not available for mounting user volume or 


volume not mounted. 


Invalid related object. The object specified in the 
RELATE parameter of the DEFINE command does not 
exist or is improper for the object being defined. 


Purge date has not expired. 
Error with a catalog recovery area define operation. 
Data set has reached the maximum number of extents. 


An OS/VS DADSM Obtain request failed during a 
VSAM catalog delete request. 


Error in specifying key length, key position, or record 
size for an alternate index or a spanned cluster. 


An unusual condition occurred during ALTER name of 
a unique or nonVSAM data set. 


An OS/VS DADSM Scratch request failed during a 
VSAM delete request for a unique or nonVSAM data 
set. 


A format-4 DSCB processing error was encountered. 
Field name is invalid. 


Field parameter list (CTGFL) contains invalid 
parameters. 


Catalog records are invalid. 


User attempted to modify a system field or nonexistent 
field. 


Control interval number is invalid. 

User provided a work area outside his address space. 
Pointer is not valid. 

Required parameter is missing. 

Specified parameters are inconsistent or conflicting. 
Entry name is invalid. 

Volume is already owned by another VSAM catalog. 
User attempted to delete a catalog that is not empty. 
No space available to suballocate. 


Deletion of space object did not cause volume to be 
deleted. 


Not enough storage is available for work area. 


Specified device-type is not supported. 
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Return Code 
Set in CCA’s 
CCAPROB Field 


172 (AC) 
176 (BO) 
180 (B4) 
184 (B8) 


188 (BC) 
192 (CO) 


196 (C4) 


200 (C8) 


204 (CC) 
208 (DO) 
212 (D4) 
216 (D8) 
220 (DC) 
224 (EQ) 


226 (E2) 
228 (E4) 
230 (E6) 


232 (E8) 
234 (EA) 


236 (EC) 
238 (EE) 


240 (FO) 
242 (F2) 


244 (F4) 


248 (F8) 


250 (FA) 


252 (FC) 


Symbolic 


Name 
RCDUPNVL 
RCNSPVTC 
RCDSNFND 
RCDSO 


RCCATUNA 
RCMLRSZ 


RCMCISZD 


RCMCISZI 


RCKEYINC 
RCBUFSIZ 
RCSIZCAL 
RCVTCBAL 
RCDOSVTC 
RCMXGRP 


RCTSAUTH 
RCLOCKER 
RCHIGH 


RCSMFER 
RCLEOD 


RCSMAPE 
RCNOUCEN 


RCINDER 
RCEFRMPH 


RCEF 


RCVOLENT 


RCEFRM 


RCEE 


Meaning of Return Code 

Volume has duplicate data space name. 
No space available on VTOC for DSCB. 
Data space was not found. 


Data set is currently open, so the catalog record cannot 
be modified. 


The catalog is unavailable. 


Maximum logical record length specified is greater than 
32,761 for a nonspanned data set. 


Data component control interval size specified is greater 
than 32,767. 


Index component control interval size specified is 
greater than maximum block size of index device. 


Key extends beyond end of record. 

Buffer size is too small. 

Control interval size cannot be calculated. 
Volume’s VTOC is invalid. 

DOS VTOC cannot be converted to OS/VS VTOC. 


Catalog record has exceeded the maximum number of 
sets of fields allowed. 


Test authorization macro failed. 
Error detected in time-of-day clock. 


VSAM catalog retrieve of a control interval failed to get 
a low-range record from the VSAM catalog. 


Error detected in SMF processing. 


End of data encountered while reading the low data key 
range of the VSAM catalog. 


Error detected in scanning the space map. 


No user catalog entry in the master catalog for convert 
volume processing. 


Required DD statement missing. 


A physical I/O error occurred during an erase of data 
set being deleted. 


Erase operation failed—-DELETE operation was not 
performed. 


The volume catalog record (identified with a 
caller-specified volume serial number) was not found. 


VSAM record management found a logical error during 
erase processing while deleting a VSAM data set. 


Error was detected, and the operation was not 
completed. 
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Alphabetic List of the Catalog Management Error Return Code Symbolic Names 


Name Code Name Code 
RCBLKVCK _ 128(80) RCKEYINC  204(CC) 
RCBUFSIZ 208(DO) RCLEOD 234(EA) 
RCCAT 4(04) RCLOCKER 228(E4) 
RCCATBAL _ 116(74) RCMCISZD __ 196(C4) 
RCCATUNA _ 188(BC) RCMCISZI 200(C8) 
RCCRAOP 88(58) RCMISPAR _ 136(88) 
RCDATE 84(54) RCMLRSZ 192(CO) 
RCDNECAT _— 152(98) RCMXGRP = 224(E0) 
RCDOSVTC = _220(DC) RCNAME 64(40) 
RCDSEXT 92(5C) RCNMNTD — 72(48) 
RCDSNF 36(24) RCNOSP 68(44) 
RCDSNEND __ 180(B4) RCNOSPSA _— 156(9C) 
RCDSO 184(B8) RCNOUCEN 238(EE) 
RCDUPNVL _ 172(AC) RCNSPVTC _ 176(BO) 
RCEE 252(FC) RCNTFMT4 _— 106(6A) 
RCEF 244(F4) RCNUNIT 76(4C) 
RCEFRM 250(FA) RCOBTAIN  94(5E) 
RCEFRMPH 242(F2) RCRELOP 80(50) 
RCENT 8(08) RCRENAME §98(62) 
RCHIGH 230(E6) RCS 0(0) 
RCINCI 124(7C) RCSCRTCH _ 102(66) 
RCINCNPM _— 140(8C) RCSEC 56(38) 
RCINCPL 32(20) RCSIZCAL 202(D4) 
RCINDER 240(F0) RCSMFER 232(E8) 
RCINENT 60(3C) RCSPANCK — 96(60) 
RCINENTN _ 144(90) RCSMAPE 236(EC) 
RCINFNAM __ 108(6C) RCSYSFLD 120(78) 
RCINFPL 112(70) RCTSAUTH = 226(E2) 
RCINFUNC = 48(30) RCVLSM 44(2C) 
RCINPTR 132(84) RCVLSZ 40(28) 
RCINSP 20(14) RCVNDSPD __ 160(A0) 
RCINSSWA _ 164(A4) RCVOLENT 284(F8) 
RCINVDTY _ 168(A8) RCVOLOWN  148(94) 
RCIOL 24(18) RCVTCBAL _216(D8) 
RCIONL 28(1C) 

RCIOU 52(34) 


Control Block Manipulation Error Codes 


When the Control Block Manipulation routine returns to the caller after 
successful completion, register 15 contains 0. If the request is GENCB, 
register 0 contains the total length of the area that contains the control 
block(s). Register 1 contains the address of the area. 


When the Control Block Manipulation routine returns to the caller with a 
nonzero value in register 15, an error occurred. If the request is TESTCB and 
the caller supplied a ERET keyword, return is to the location specified by the 
ERET keyword. Otherwise, the Control Block Manipulation routine returns 
control to the point of invocation, via the return address in register 14. 


Register 15 contains a return code: 
Code Description 


0 Successful completion. 

4 An error has been detected. The error code in register 0 indicates the type of 
error. 

8 Invalid use of the execute form of this macro instruction. Since the return code is 


set by the macro instruction expansion and not by the Control Block 
Manipulation routine, the register 0 contents do not indicate an error code. 
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Register 0 contains an error code: 


Code 
11) 
2(2) 
3(3) 
4(4) 
5(5) 
6(6) 


7(7) 
8(8) 


9(9) 

10(A) 
11(B) 
12(C) 
13(D) 
14(E) 


15(F) 
16(10) 


19(13) 


20(14) 


21(15) 


Applicable 
Macros* 


G,M,S,T 
G,M,S,T 
G,M,S,T 
M,S,T 
S,T 

S,T 


S,T 


Condition 

The function type is invalid. 

The control-block type is invalid. 

The keyword type is invalid. 

The control block to be processed isn’t of the type specified. 
The ACB to be processed is closed—it must be open. 


The cluster whose index component was to be processed isn’t 
key-sequenced (doesn’t include an index). 


The EXLST entry to be processed isn’t present. 


Not enough virtual storage is available, or (with AM=VTAM 
specified) list and execute forms are inconsistent. 


User area is too small. 

Exit address isn’t specified in the input. 

The RPL to be processed is active, or it is already being processed. 
The ACB to be processed is open—it must be closed. 

No exit address is specified in the input for the exit to be activated. 


An invalid combination of option codes (for example, for MACRF 
or OPTCD) is specified. 


The user area isn’t on a fullword boundary. 

A VTAM keyword is specified with AM=VTAM not specified. 

A specified keyword refers to a field beyond the end of the control 
block to be processed. 


A specified keyword requires processing with shared resources to ; 
be specified, but it isn’t. 

The block to be displayed or tested does not exist because the data 

set is a dummy data set. 


* G=GENCB, M=MODCB, S=SHOWCB, T=TESTCB 
All errors in control block manipulation are detected by IDA019C1. 


Virtual-Storage Management 


The getting and freeing of storage for VSAM control blocks is managed 
centrally by IDA0192M. To allocate storage efficiently, IDAQ192M (in most 
cases) gets storage in blocks large enough to satisfy not only a current request 
for storage for a control block, but also subsequent requests for storage for 
the same or a related control block. Figure 75 indicates: 


e What control block(s) are stored in each type of storage block 


e What block gives the address of each storage block 


e What subpool each storage block is located in (subpools 254, 241, 245, 
and 252 are protected with key 0; subpool 250 is unprotected—attributes 
of system subpools are described in OS/VS2 Supervisor Logic) 


e The size of each storage block 


e Whether each storage block is fixed in real storage by Open 
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Pointed Gotten Fixed in Real Storage 
Storage Block Contains to by in Subpool! Size® by Open? 


Blocks Related to the Job 
Step as a Whole 


Sphere Block ACBs for the base BIB 250 1K or No 
cluster (path larger 
processing) and the 
alternate indexes 
in the upgrade set, 

RPLs for the 
alternate indexes 
in the upgrade set, 


UPT 
Protected Sphere AMBLs for the base BIB 252 1K or No 
Block cluster (path larger 


processing) and the 
alternate indexes 
in the upgrade set, 


HEBs 
Blocks Related to a 
Particular Cluster 
Buffer Block I/O buffer CMB 250 Length of Nod 
buffer 
Upgrade Buffer I/O buffer CMB 250 Length of No 
Block2 buffer 
DEB Block DEB CMB 2544 Length of No 
DEB 
EDB Block EDB CMB 252 Length of No° 
EDB 
String Block3 BUFCs, CPAs, IOBs, CMB 250 4K or No> 
PLHs, RPLs for larger 
path PLHs, WAXs 
for Path PLHs 
Fixed String PFL CMB 2544 1/2K or No 
Block larger 
Upgrade String BUFCs,CPAs,IOBs, CMB 250 4K or No 
Block2 PLHS larger 
Fixed Upgrade PFL CMB 254 Length of No 
String Block PFL 
User Block AMBs, AMDSBs, CMB 250 1K or No> 
ARDBs, BUFC larger 
headers, preformat 
BUFCs, preformat 
CPAs, [WAs 
Protected User LPMBs CMB 252 3 LPMBs, + No? 
64 bytes 
for set 


sector table 
1 Subpool is 241 for a catalog or a catalog recovery area built in system storage. 
2 This block doesn’t exist for a catalog or a catalog recovery area built in system storage. 
3 This block doesn’t exist for processing with local shared resources. 
4 Subpool is 245 for a catalog or a catalog recovery area built in system storage. 


3 This block is fixed in real storage, by Open if the user requests it for “fast path” (improved control-interval) 
processing. 


6 The sizes are given for time of allocation. After Open termination, excess storage will have been freed. 
7 This block doesn’t exist with “fast path” (improved control interval) processing. 


Figure 77. Storage Blocks used for Virtual-Storage Management. 
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To allocate and free storage in a storage block, IDA0192M uses these control 
blocks (which are described in detail in ‘‘Data Areas’’): 


e BIB—the base information block is built in subpool 252 upon a request to 
build it from the VSAM Open module IDA0192A. One BIB is built for all 
processing related to a particular base cluster in the job step. 


e CMB—the cluster management block is built in subpool 252 upon the first 
request to open a particular cluster from the VSAM Open module 
IDA0192F. It enables IDA0192M to control the allocation and freeing of 
control blocks for the cluster. It contains the addresses of the header 
elements in header element blocks (described next) that identify the 
storage blocks that contain control blocks for the cluster. 


After a CMB has been built for a cluster, subsequent requests for storage 
for control blocks for the cluster (related to the same open) are satisfied, if 
possible, by using storage blocks already obtained. As storage blocks fill 
up, IDA0192M gets additional ones. 


e HEB—the header element block is built (in the protected sphere block) by 
IDA0192M to manage the allocation and freeing of unprotected storage 
blocks. A HEB contains 16 header elements, each of which, when used, 
identifies and describes a storage block. The CMB indicates by the position 
of an entry that points to a header element what type of storage block the 
header element describes. The header element gives the block’s address, 
length, subpool number, and available space. It doesn’t give the address 
within the block of individual control blocks. These addresses are given by 
the control blocks within the VSAM control block structure, which is 
described in “Data Areas.”’ 


Figure 78 gives the interrelationship of these control blocks. It shows two 
storage blocks obtained for DEBs. Storage blocks are obrained for other 
control blocks in the same way. A DEB block is just large enough to contain 
the DEB for which storage is requested. Some other storage blocks are large 
enough to contain several control blocks of the same or a related type, for 
which storage might be requested subsequently. 


As a by-product, these control blocks map the location, by storage block, of 
VSAM control blocks for clusters (and associated paths and upgrade sets). 
BIBs, CMBs, and HEBs are in protected storage; they can be used to find a 
control block when a pointer in the VSAM control block structure has been 
destroyed or can’t be found. 
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Figure 78. Virtual-Storage Management Control Block Structure 
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GLOSSARY 


Abbreviations 


Following is an alphabetized list of the abbreviations used in 
this book and in the VSAM code listings. 


ABEND: abnormal end 

ACB: access method control block 

ADDR: addressed processing or addressed 
ADR: same as ADDR 

AIX: alternate index 

AMB: access method block 

AMBL: access method block list 

AMCBS: access method control block structure control block 
AMDSB: access method data statistics block 
AMS: Access Method Services 

AM/0: Virtual Storage Access Method (VSAM) 
ARDB: address range definition block 

ASPT: available space pointer 

ATIOT: alternate task input/output table 

BIB: base information block 

BISAM: basic indexed sequential access method 
BLK: block, control interval 

BLPRM: BDLVRP parameter list 

BSPH: buffer subpool header 

BUFC: buffer control block 

BWD.: backward (processing) 

CA: control area 

CAXWA: catalog auxiliary work area 

CCA: catalog communication area 

CCB: command control block 

CCR: catalog control record 

CHKPT: checkpoint 

CI: control interval 

CICB: ISAM interface control block 

CIDF: control interval definition field 

CLW: close work area 

CM: catalog management 

CMB: cluster management block 

CMS: VSAM catalog management services 
CNV: control interval or control-interval processing 
core: virtual storage 

CPA: channel program area 

CPL: catalog parameter list (CTGPL) 


CRA: catalog recovery area 


CSL: core save list 

CTGCV: catalog control volume 
CTGFL: field parameter list (FPL) 
CTGFV: field vector table (FVT) 
CTGPL: catalog parameter list (CPL) 
CTGVL: catalog volume list 
CTGWA: catalog work area 

CVT: communications vector table 
DCB: data control block 
DDNAME: data definition name 
DEB: data extent block 

DIR: direct processing 

DIWA: data insert work area 
DSCB: data set control block 

DSL: DEB save list 

DSNAME: data set name 

DSORG: data set organization 
ECB: event control block 

EDB: extent definition block 
ENDREQ: end the request 

EOD: end of data 

EOF: end of file 

EOV: end of volume 

ERFLG: error flags 

ESDS: entry-sequenced data set 
ESL: enqueue save list 

EXCD: exceptional conditions 
EXCP: execute channel program 
EXLST: exit list 

Ext Proc: external procedure 

FKS: full key search 

Fn: format n 

FPL: field parameter list (CTGFL) 
FS: free space 

FVT: field vector table (CTGFV) 
FWD: forward (processing) 

GC: type code (group code) 

GEN: generic key search 

GO: Set of fields (group occurrence) 
GOP: Set-of-fields pointer (group occurrence pointer) 
HEB: header element block 


ICIP: improved control-interval processing 


Glossary 659 


ICWA: index create work area 

ID: identifier 

IDAL: indirect data-address list (real page list) 
II: ISAM interface 

IICB: ISAM interface control block 
IMWA: index modification work area 

Int Proc: internal procedure 

I/O: input/output 

IOB: input/output block 

ISAM: indexed sequential access method 
IXSPL: index search parameter list 
JFCB: job file control block 

JSCB: job step control block 

KEQ: search on key equal 

KEY: keyed accessing 

KGE: search on key greater or equal 
KSDS: key-sequenced data set 

L: link 

LLOR: least length of record (that contains all key fields) 
LOC: locate 

LPMB: logical-to-physical mapping block 
LSR: local shared resources 

MACR: macro instruction reference 
MOD: module 

MSS: Mass Storage System 

MSVI: Mass storage volume inventory 
MWA: module work area 

n: integer number 

NSI: next sequential instruction 

NSP: next string position 

NUP: no update 

O/C/EOV: Open/Close/End-of-Volume 
OFLG: open flags 

OPTCD: option code 

OPW: Open work area 

OPWA: (same as OPW) 

OPWRK: (same as OPW) 

OS/VS: operating system/virtual storage 
PCCB: private catalog control block 
PFL: page fix list 

PFPL: PGFIX parameter list (same as PFL) 
PL/I: programming language/one 

PL/S: programming language/systems 


PLH: placeholder 


PLHDR: placeholder header 

PROC: procedure 

PSR: Programming Systems Representative 
PSW: program status word 

PUT: write-a-record command 

QISAM: queued indexed sequential access method 
RAB: record area block 

RB: request block 

RBA: relative byte address 

RDF: record definition field 

REP: replication 

RM: record management 

Rn: general-purpose register n 

RPL: request parameter list 

RPLE: RPL extension for ISAM interface processing 
RPS: rotational position sensing 

RRDS: relative record data set 

RTN: routine 

SCIB: search compressed index block 

SCRA: catalog recovery area in system storage 
SEQ: sequential or sequential processing 
SKP: skip sequential or skip sequential processing 
SMF: system management facilities 

SSL: swap save list 

SST: set sector table 

STRNO: number of RPL strings 

SVC: supervisor call 

TCB: task control block 

TIOT: task I/O table 

TSO: time sharing option 

UCB: unit control block 

UCRA: catalog recovery area in user’s storage 
UPD: update mode (or data modify) 

UPT: upgrade table 

USVR: user security verification routine 

VAT: valid-AMBL table 

VL: variable length 

VMT: volume mount table 

VPL: virtual page list 

VRP: VSAM resource pool 

VSAM: virtual storage access method 

VSL: virtual subarea liast (same as PFL) 
VSRT: VSAM shared resource table 


VTOC: volume table of contents 
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VVIC: (replaced by MSVI) 

WAX: work area for path processing 

WSHD: 

WTG: where-to-go table working storage header 
XCTL: transfer control (macro instruction) 
XPT: checkpoint 


XREF: cross reference 


Definitions of Terms Used In This 
Book 


The following terms are defined as they are used in this book. 
If you do not find the term you are looking for, refer to the 
index or tothe JBM Data Processing Glossary, GC20-1699. 


Access Method Services: A multifunction service program that 
defines VSAM data sets and allocates space for them, 
converts indexed sequential data sets to key-sequenced data 
sets with indexes, modifies data-set attributes in the catalog, 
reorganizes data sets, facilitates data portability between 
operating systems, creates backup copies of data sets and 
indexes, helps make inaccessible data sets accessible, and lists 
data-set records and catalog entries. 


addressed direct access: The retrieval or storage of a data 
record identified by its relative byte address, independent of 
the record’s location relative to the previously retrieved or 
stored record. See also keyed direct access, addressed 
sequential access, and keyed sequential access.) 


addressed sequential access: The retrieval or storage of a data 
record in its entry sequence relative to the previously 
retrieved or stored record. (See also keyed sequential access, 
addressed direct access, and keyed direct access.) 


alternate index: A collection of index entries organized by the 
alternate keys of its associated base data records. 


alternate-index cluster: The data and index components of an 
alternate index. 


application: As used in this publication, the use to which an 
access method is put or the end result that it serves; 
contrasted to the internal operation of the access method. 


base catalog record: The first catalog record (control interval) 
that describes the VSAM object. This record contains the 
object’s data set name, cluster name, or volume serial number 
in the ENTNAME field. This record also contains the header 
fields required for the object. The base catalog record can 
contain set-of-fields pointers that point to sets of fields in the 
base catalog record, or that point to sets of fields in extension 
records (vertical extension). The base catalog record’s 
extension pointer can point to a control interval that 
continues the information (set-of-fields pointers) contained in 
the base catalog record (horizontal extension). 


base cluster: A key-sequenced or entry-sequenced cluster over 
which one or more alternate indexes are built. 


candidate volume: A direct-access storage volume that has 
been defined in a VSAM catalog as a VSAM volume; VSAM 
can automatically allocate space on this volume, as needed. 


catalog: (See master catalog and user catalog.) 
catalog recovery area: (See CRA.) 


cluster: A combination of related VSAM data sets, identified 
by one name in a VSAM catalog and requiring a single DD 
statement. A key-sequenced data set and its index form a 
cluster; an entry-sequenced data set alone forms a cluster. 


collating sequence: An ordering assigned to a set of items, such 
that any two sets in that assigned order can be collated. As 
used in this publication, the order defined by the System/370 
8-bit code for alphabetic, numeric, and special characters. 


compendium: A compendium gathers together and presents in 
concise form all the essential facts and details about a VSAM 
functional unit. 
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component: A named, cataloged collection of stored records. 
The lowest member in the data structure hierarchy. A data 
set contains at least one component, and the component can 
contain no subsets. 


compression: (See key compression.) 


contro] area: A group of control intervals used as a unit for 
formatting a data set before adding records to it. Also, ina 
key-sequenced data set, the set of control intervals pointed to 
by a sequence-set index record; used by VSAM for 
distributing free space and for placing a sequence-set index 
record adjacent to its data. 


control-area split: The movement of the contents of some of 
the control intervals in a control area to a newly created 
control area, to facilitate the insertion or lengthening of a 
data record when there are no remaining free control 
intervals in the original control area. 


control interval: A fixed-length area of auxiliary-storage space 
in which VSAM stores records and distributes free space. It is 
the unit of information transmitted to or from auxiliary 
storage by VSAM, some integer multiple of blocksize. 


control-interval split: The movement of some of the stored 
records in a control interval to a free control interval, to 
facilitate the insertion or lengthening of a record that won't 
fit in the original control interval. 


CRA: Catalog recovery area. An entry-sequenced data set 
that exists on each volume owned by a recoverable catalog, 
including the catalog volume itself. The CRA contains 
self-describing records as well as duplicates of catalog records 
that describe the volume. 


data integrity: Preservation of data or programs for their 
intended purpose. As used in this publication, the safety of 
data from inadvertent destruction or alteration. 


data record: A collection of items of information from the 
standpoint of its use in an application and not from the 
standpoint of the manner in which it is stored. (See also 
stored record.) 


data security: Prevention of access to or use of data or 
programs without authorization. As used in this publication, 
the safety of data from unauthorized use, theft, or purposeful 
destruction. 


data set: The major unit of data storage and retrieval in the 
operating system, consisting of data in a prescribed 
arrangement and described by control information to which 
the system has access. As used in this publication, a collection 
of fixed- or variable-length records in auxiliary storage, 
arranged by VSAM in key sequence or in entry sequence. 
(See also key-sequenced data set and entry-sequenced data 
set.) 


data space: A storage area defined in the volume table of 
contents of a direct-access volume for the exclusive use of 
VSAM to store data sets, indexes, and catalogs. 


direct access: The retrieval or storage of data by a reference to 
its location in a data set rather than relative to the previously 
retrieved or stored data. (See also addressed direct access 
and keyed direct access.) 


distributed free space: Space reserved within the control 
intervals of a key-sequenced data set for inserting new 
records into the data set in key sequence; also, whole control 
intervals reserved in a control area for the same purpose. 


entry sequence: The order in which data records are physically 
arranged in auxiliary storage, without respect to their 
contents. (Contrast to key sequence.) 


entry-sequenced data set: A data set whose records are loaded ) 
without respect to their contents, and whose relative byte 

addresses cannot change. Records are retrieved and stored by 

addressed access, and new records are added at the end of the 

data set. 


extent: A continuous space allocated on a direct-access 
storage volume, reserved for a particular data space or data 
set. 


extension record: The continuation of a catalog record that 
contains set-of-fields pointers and their sets of fields. 
Set-of-fields pointers in an extension record always point to 
sets of fields within the extension record. The extension 
record’s extension pointer can point to a control interval that 
contains part of a set of fields too large to fit in the extension 
record (horizontal extension). 


external procedure: A procedure that can be called by any 
other VSAM procedure; a procedure whose name is in the 
module’s (assembler listing) ““external symbol dictionary.”’ 


field: In a record or a control block, a specified area used for 
a particular category of data or control information. 


free space: (See distributed free space.) 


generic key: A high-order portion of a key, containing 
characters that identify those records that are significant for a 
certain application. For example, it might be desirable to 
retrieve all records whose keys begin with the generic key AB, 
regardless of the full key values. 


group code: (See type code.) ' 
group occurrence: (See set of fields.) J 
group occurrence pointer: (See set-of-fields pointer.) 


horizontal extension: An extension record pointed to by a 
catalog record’s extension field. (See also vertical extension.) 


horizontal pointer: A pointer in an index record that gives the 
location of another index record in the same level that 
contains the next key in collating sequence; used for keyed 
sequential access. 


index: As used in this publication, an ordered collection of 
pairs, each consisting of a key and a pointer, used by VSAM 
to sequence and locate the records of a key-sequenced data 
set; organized in levels of index records. (See also index 
level, index set, and sequence set.) 


index entry: A key and a pointer paired together, where the 
key is the highest key (in compressed form) entered in an 
index record or contained in a data record in a control 
interval, and the pointer gives the location of that index 
record or control interval. 


index level: A set of index records that order and give the 
location of records in the next lower level or (sequence set 
record) that give the location of control intervals in the 
control area that it is associated with. 


index record: A collection of index entries that are retrieved 
and stored as a group. (Contrast to data record.) 


index replication: The use of an entire track of direct-access 
storage to contain as many copies of a single index record as 
possible; reduces rotational delay. 
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index set: The set of index levels above the sequence set. The 
index set and the sequence set together comprise the index. 


index upgrade: The process of reflecting changes made to a 
base cluster in its associated alternate indexes. 


integrity: (See data integrity.) 


internal procedure: A procedure that can be called only by 
other procedures within the module. (See also external 
procedure.) 


ISAM interface: A set of routines that allow a processing 
program coded to use ISAM (indexed sequential access 
method) to gain access to a key-sequenced data set with an 
index. 


key: One or more characters within an item of data that are 
used to identify it or control its use. As used in this 
publication, one or more consecutive characters taken from a 
data record, used to identify the record and establish its order 
with respect to other records. (See also key field and generic 
key.) 


key compression: The elimination of characters from the front 
and the back of a key that VSAM does not need to distinguish 
the key from the preceding or following key in an index 
record; reduces storage space for an index. 


key field: A field located in the same position in each record 
of a data set, whose contents are used for the key of a record. 


key sequence: The collating sequence of data records, 
determined by the value of the key field in each of the data 
records. May be the same as, or different from, the entry 
sequence of the records. 


key-sequenced data set: A data set whose records are loaded in 
key sequence and controlled by an index. Records are 
retrieved and stored by keyed access or by addressed access, 
and new records are inserted in the data set in key sequence 
by means of distributed free space. Relative byte addresses of 
records can change. 


keyed direct access: The retrieval or storage of a data record 
by use of an index that relates the record’s key to its relative 
location in the data set, independent of the record’s location 
relative to the previously retrieved or stored record. (See also 
addressed direct access, keyed sequential access, and 
addressed sequential access.) 


keyed sequential access: The retrieval or storage of a data 
record in its key sequence relative to the previously retrieved 
or stored record, as defined by the sequence set of an index. 
(See also addressed sequential access, keyed direct access, 
and addressed direct access.) 


mass sequential insertion: A technique VSAM uses for keyed 
sequential insertion of two or more records in sequence into a 
collating position in a data set: more efficient than inserting 
each record directly. 


mass storage volume: Two data cartridges in the IBM 3850 
Mass Storage System that contain information equivalent to 
what could be stored on a direct-access storage volume. 


master catalog: A key-sequenced data set with an index 
containing extensive data-set and volume information that 
VSAM requires to locate data sets, to allocate and deallocate 
storage space, to verify the authorization of a program or 
operator to gain access to a data set, and to accumulate usage 
statistics for data sets. 


password: A unique string of characters stored in a catalog 
that a program, a computer operator, or a terminal user must 
supply to meet security requirements before a program gains 
access to a data set. 


path: A named, logical entity composed of one or more 
clusters (an alternate index and its base cluster, for example). 


physical record: On a track of a direct-access storage device, 
the space between interrecord gaps. 


pointer: An address or other indication of location. For 

example, an RBA is a pointer that gives the relative location 
of a data record or a control interval in the data set to which 
it belongs. (See also horizontal pointer and vertical pointer.) 


portability: The ability to use VSAM data sets with different 
operating systems. Volumes whose data sets are cataloged in 
a user catalog can be demounted from storage devices of one 
system, moved to another system, and mounted on storage 
devices of that system. Individual data sets can be transported 
between operating systems using Access Method Services. 


prime index: The index component of a key-sequenced data 
set having one or more alternate indexes. (See also index and 
alternate index.) 


prime key: The key of reference for a key-sequenced data set 
when it was loaded. (See also key.) 


procedure: A functional unit of VSAM code that is entered 
only at one entry point and exits at the end of the procedure 
(the last line of the procedure’s code). The procedure can call 
(transfer control, with a return to the procedure expected) 
other procedures within the module (internal calls) and can 
call other procedures in other VSAM modules (external 
calls). (See also internal procedure and external procedure. ) 


random access: (See direct access.) 


RBA: Relative byte address. The displacement of a data 
record or a control interval from the beginning of the data set 
to which it belongs; independent of the manner in which the 
data set is stored. 


record: (See index record, data record, stored record.) 
relative byte address: (See RBA.) 


relative record data set: A data set whose records are loaded 
into fixed-length slots. 


relative record number: A number that identifies not only the 
slot in a relative record data set but also the record occupying 
the slot. 


replication: (See index replication.) 


reusable data set: A VSAM data set that can be reused as a 
work file, regardless of its old contents. 


security: (See data security.) 


segment: The portion of a spanned record contained within a 
control interval. (See also spanned record.) 


sequence set: The lowest level of the index of a key-sequenced 
data set; it gives the locations of the control intervals in the 
data set and orders them by the key sequence of the data 
records they contain. The sequence set and the index set 
together comprise the index. 


sequential access: The retrieval or storage of a data record in 
either its entry sequence or its key sequence, relative to the 
previously retrieved or stored record. (See also addressed 
sequential access and keyed sequential access.) 
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set of fields: A group of catalog record fields that contain 
related information. Sets of fields are referred to in the code 
as ‘“group occurrences’”’ or ““GOs.”’ 


set-of-fields pointer: A field used to identify and locate a set of 
fields by its displacement from the beginning of the record’s 
sets of fields (the set of fields is in the same control interval as 
the set-of-fields pointer) or by a control interval number (the 
set of fields pointer is in the base catalog record or its 
extension and the set of fields is in an extension record). 
Set-of-fields pointers are grouped by type code and are in 
ascending sequence by sequence number. Set-of-fields 
pointers are referred to in the code as “group occurrence 
pointers” or ““GOPs.”’ 


shared resources: A set of functions that permit the sharing of 
a pool of I/O-related control blocks, channel programs, and 
buffers among several VSAM data sets open at the same 
time. 


skip sequential access: Keyed sequential retrieval or storage of 
records here and there throughout a data set, skipping 
automatically to the desired record or collating position for 
insertion: VSAM scans the sequence set to find a record ora 
collating position. 


spanned record: A record whose length exceeds 
control-interval lengthened and, as a result crosses, or spans, 
one or more control interval boundaries within a single 
control area. 


stored record: A data record, together with its control 
information, as stored in auxiliary storage. 


string: The part of a control block structure built around a 
placeholder (PLH) that enables VSAM to keep track of one 
position in the data set that the control block structure 
describes. 


type code: A code that identifies the set-of-fields type. Type 
codes are referred to in the code as “‘group codes” or “‘GCs.”’ 
(See ‘“Field Name Dictionary” for a list of type codes.) 


upgrade set: All the alternate indexes that VSAM has been 
instructed to update whenever there is a change to the data 
component of the base cluster. 


user catalog: A catalog used in the same way as the master 
catalog, but optional and pointed to by the master catalog, 
and also used to lessen the contention for the master catalog 
and to facilitate volume portability. 


vertical extension: An extension record pointed to by a 
set-of-fields pointer in the object’s base catalog record or its 
horizontal extension. (See also base catalog record and 
horizontal extension.) 


vertical pointer: A pointer in an index record of a given level 
that gives the location of an index record in the next lower 
level or the location of a control interval in the data set 
controlled by the index. 
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abbreviations, list of 659 
ABEND macro 634 
issued by Open processing 31 
ACB control block 
conditions before open 47 
described and illustrated 547 
mapped by IFGACB macro 633 
STRNO parameter and the number of placeholders 75 
used during 
Close processing 45,47 
End of Volume processing 59 
Open processing 31 
Access Method Services 
and VSAM catalog management processing 225 


acquiring a free space control area during key-sequenced data 


set modification 97 
acronyms, list of 659 
add-to-end processing 
during data set creation 83 
during key-sequenced data set modification 97 
adding a 


control interval to the data set for the user’s program 129 


new set of fields to a catalog record 219 
ADDREC macro 634 
and DEFINE CATALOG processing 243 
and DEFINE CLUSTER processing 233 
addressed processing 
GET 
direct 79 
sequential 81 . 
POINT 119 
restrictions 75 
allocating 
more space toa dataset 197 
and sequence set with data 199 
extent descriptor for 199 
from a nonunique data space 209 
part of a data space’s space (SUBALLOCATE 
processing) 384 
space to a VSAM data set or key range 59 
ALTER processing 255 
alternate index 
access by way of 145 
closing the upgrade set 53 
control block structure 539 
format 474 
opening the upgrade set 39 
upgrading 147 
alternate index catalog record 496 
association set of fields 497 
description 496 
format 496 
password set of fields 498 
alternate key 474 
AMB control block 
described and illustrated 550 
mapped by IDAAMB macro 631 


used during 
Close processing 47 
End of Volume processing 49 
AMBL control block 
described and illustrated 552 
mapped by IDAAMBL macro 631 
used during 
Close processing 47 
Open processing 31 
AMCBS control block 
described and illustrated 555 
mapped by AMCBS macro 631 
AMCBS macro 631 
(See also AMCBS control block) 555 
AMDSB control block 
described and illustrated 555 
mapped by IDAAMDSB macro 631 
used during Close processing 47 
AMDSSB set of fields 
description 490 
used in data set catalog record 492 
used in index catalog record 492 
RESET processing 200 
amendments, summary of 15 
AMP parameter (JCL DD parameter) used to specify ISAM 
SYNAD routine 47 
ARDB control block 
described and illustrated 556 
mapped by IDAARDB macro 631 
used during data set creation 91,93 
argument controlentry 161,162,164 
assignment of 
candidate volumes 
after the data set or catalog has been created 255 
during DEFINE CLUSTER processing 233 
catalog control intervals 487 
CRA control intervals 408 
placeholders to a request string, effect of 
ENDREQ on 75 
RPL to catalog management requests 175 
association set of fields 
cluster 
used in a data set catalog record 492 
used in an index catalog record 492 
data set and index 
used in acluster catalog record 495 
description 480 
illustrated 480 
asynchronous 
processing (CHECK) 125 
request, deferred 77 
available-space map (LSPACE processing) 213 
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backward processing 81 
BIB control block 
built by Open 33 
description 558 
mapped by IDABIB macro 631 
virtual-storage management 654 
BISAM (basic indexed sequential access method) request 
translation 159 
bit manipulation routine, used during SUBALLOCATE 
processing 209 
BLDVRP processing 63 
blocksize 472 
BLPRM parameter list 
described and illustrated 559 
mapped by IDABLPRM 631 
BSPH control block 
description 561 
mapped by IDABSPH macro 631 
BUFC control block 
described and illustrated 562 
mapped by IDABUFC macro 631 
used during CHECK processing 125 
buffer assignment to create-mode PUT processing 85 
Buffer Management 
method of operation 149 
program organization 346 
buffer request list (in BLPRM) 560 
buffers built for ISAM-Interface user 35 
building a(n) 
available-space map (LSPACE processing) 213 
control block dynamically (GENCB processing) 161 
index entry and inserting it into an index record 
during key-sequenced data set modification 105 
index entry for a completed data control interval 91 
during data set creation 91 
initialization of an index buffer 91 
section entry processing 91 
building an index entry after a control area split 103 
building a VSAM resource pool 63 
bypassing password checking 177 
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CALLSF macro 634 
CALL EXIT macro 634 
candidate volume processing 209 
and SUBALLOCATE processing 208 
DEFINE SPACE processing 251 
deletion of a dataset’s 265 
End of Volume processing 59 
catalog 
assigning catalog control intervals 487 
communications area (CCA) register save area 639 
control interval 479 
converting volumes to or from mass storage 276 
CONVERTYV processing 276 
debug aid 637 
field name dictionary 523 
format 475 
high-address range of the catalog 476 
identifier (inthe CTGPL) 173 
low-address range of the catalog 477 


management 
control block interrelationships 543 
error codes, set in CCAPROB 650 
I/O functions 392 
OS/VS 
(See CVOL entries) 
overview 170 
procedure called-by directory 458 
procedure calls directory »436 
procedure name abbreviations, used in program 
organization compendium figures 280 
processing 359 
services processing 227,384 
summary of 20 
names/volume area (CTGCV) 583 
record 
alternate index 496 
associations, illustrated 480 
cluster 493 
control 485 
CRA 518-522 
data set 487 
extension 215,223,516 
free 486 
index 487 
locating fields ina 481 
modifying a field’s value ina 219 
nonVSAM 505 
obtaining a field’s value ina 215 
path 499 
recovery area 518,522 
sets of fields, types of 480 
that describe the catalog 481 
true name 484 
upgrade 502 
user-catalog 507 
volume 510 
recovery 482 
recovery area 482,520 (See also CRA) 
summary of 19 
volume list (CTGVL) 588 
work area (CTGWA) 588 
CATLG macro 634 
(See also entries for catalog management and SVC 26) 
CATPROB macro 634 
CAXWA control block 
described and illustrated 564 
mapped by IGGCAXWA macro 633 
CCA control block 
described and illustrated 566 
mapped by IGGCCA macro 633 
register save area 639 
CCAPROB field 650 
changing a data set’s DSNAME 257 
channel programs 
built 149 
format 580 
CHECK processing 125 
and the user’s SYNAD exit routine 125 
issued by a BISAM-user’s program 159 
checking a password 176 
checking user-supplied CTGFVs during DEFINE 
processing 231 
CIDF (control interval definition field) 470 
CIRB macro 631 
CLCL macro 631 
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CLOSE macro 634 control interval 


issued by ISAM interface 47 definition field 470 
CLOSE, OS/VS (See OS/VS CLOSE) format 468 
CLOSE processing 47 free space ina 472 
catalog 47,298 processing 
cluster and restrictions 75 
from ISAM program 290 GET processing 129 
from VSAM program 292 PUT processing 
more than one dataset atatime 49 add a new control interval 131 
CLOSE, TYPE=T (temporary close) 47,298 restrictions 133 
Close work area (see CLW work area) update acontrol interval 133 
cluster catalog record record definition field (RDF) format 469 
and its association set of fields splitting 325,472 
data and index 495 password 177 
used during Open processing 33 control-interval access 
format 493 improved 129,133 
and its password set of fields 495 index processing 128,132 
CLW work area converting a volume to or from mass storage 276,384 
described and illustrated 577 CONVERTYV processing 276,384 
mapped by IDACLWRK 631 CPA control block 
CMB control block described and illustrated 578 
description 578 mapped by IDACPA macro 631 
mapped by IDACMB 631 CRA (See also catalog, recovery area.) 
virtual-storage management 654 catalog control record 521 
COMB macro 634 cluster record 520 
(See also combination name processing) data extension record 
combination name processing description and format 521 
during LOCATE processing 181 volume information set of fields 522 
during UPDATE processing 195 data record 
conditional processing AMDSSB set of fields 519 
during LOCATE processing 181 association set of fields 519 
during UPDATE processing 195 description and format 518 
connecting volume information set of fields 520 
another system’s VSAM user catalog to your system’s free record 518 
master catalog (IMPORT processing) 249 record processing 
a user’s program to a data set (Open processing) 31 adding 404 
control area deleting 405 
format 473 updating 403 
splitting 326,473 create-ENDREQ processing 121 
control block creating (a VSAM/nonVSAM object) 
checkpointing 64 an ACB, EXLST, or RPL (GENCB processing) 161 
interrelationships a key-sequenced data set 87 
alternate index 539 building an index entry for a completed data control 
before and after data set sharing 534 interval 91 
catalog management control blocks 543 getting a new free space control area 89 
data AMB structure 538 getting a new free space control interval 87 
index AMB structure 540 inserting an index entry for a new index record at the 
path processing 535 next higher level 95 
shared resources 542 a nonVSAM data set 249 
virtual-storage management 654 space for a key-sequenced data set 101 
VSAM control block structure (ISAM user) 533 a VSAM 
VSAM control block structure (VSAM user) 532 alternate index 234,390 
manipulation catalog 243 
building (GENCB processing) 161 catalog recovery area 246,390 
displaying (SHOWCEB processing) 163 cluster 233 
error codes 653 dataset 231 
modifying (MODCB processing) 163 data space 251 
summary of 20 and OS/VS DADSM processing required 253 
testing (TESTCB processing) 163 path 240,390 
recorded by the Generalized Trace Facility 639 cross-reference aids 624 
shared between two or more user programs CSL control block 
during Close processing 47 built by Open 33 
during Open processing 31 description 583 
(All control blocks used in VSAM processing are indexed mapped by IDACSL macro 631 
by abbreviation.) used by virtual-storage management 654 
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CTGCV control block 
description and format 583 
mapped by IEZCTGCH 583 
CTGFL control block 
described and illustrated 584 
mapped by IEZCTGFL macro 633 
used during Open processing 31 
LISTCAT processing 260 
LOCATE processing 180 
MODIFY processing 218 
SUPERLOCATE processing 186 
UPDATE processing 194 
CTGFLs for tests 181,195 
CTGFYV control block 
described and illustrated 585 
mapped by IEZCTGFV macro 633 
CTGPL control block 
described and illustrated 586 
mapped by IEZCTGPL macro 633 
used during Open processing 31 
SUPERLOCATE processing 186 
CTGVL control block 
description 588 
mapped by IEZCTGVL 588 
CTGWA control block 
description 588 
format for a request other than SUPERLOCATE 588 
format fora SUPERLOCATE request 588 
mapped by IEZCTGWA 588 
CVOL entries 242 
CVOL entry in the OS/VS system catalog 
during DEFINE CATALOG processing 243 
during DELETE CATALOG processing 275 
CVT macro 631 


D 


DADSM (0OS/VS) 
Allocate routine, and building the VSAM catalog 243 
Delete routine 273 
Scratch routine 265 
data-AMB control block structure 538 
data-area-definition macro instructions 631 
data areas 
(all data areas used in VSAM processing are indexed by 
abbreviation.) 
catalog 475 
(See also catalog and catalog record) 
control areaformat 473 
control interval format 468 
data setformat 468 
index format 470 
data record 
and control interval split 467 
format 487 
record definition field (RDF) format 469 
data set 
catalog record 
and its AMDSB set of fields 490 
and its association (cluster) set of fields 490 
format of 487 
header fields 487 
and its password set of fields 492 
used during Open processing 31 
and its volume information set of fields 490 


creation 
entry sequenced data set 83 
key sequenced dataset 85 
using the Access Method Services DEFINE CLUSTER 
command 233 ) 
directory entry set of fields 515 
expiration date, during DELETE processing 265 
format 467 
data record format 467 
control interval format 467 
control area format 470 
shared between two or more user programs 
control block structure before and after sharing 534 
during Close processing 47 
during Open processing 31 
data space 
containing only one VSAM object (unique) 197 
creation of 251 
deletion of 265 
extent for 197 
group set of fields 513 
shared by more than one VSAM object (nonunique) 197 
verifying a nonVSAM caller’s authorization to process 
data sets in 302 
DCB control block 
conditions before open 47 
reset of module address fields 47 
used during Close processing 47 
DCB exit routine 35 
DEB control block 
built during Open processing 35 
removing it from the TCB’s DEB chain 49 
used during End of Volume processing 61 
used during Open processing 31 
used with OS/VS system components 35 S) 
DEBCHK macro 634 
debug aid 637 
deferred requests 
asynchronous 69 
synchronous 69 
DEFINE, to create a VSAM object 
AIX processing 236,390 
CRA processing 246,390 
PATH processing 240,390 
CATALOG processing 243,385 
CLUSTER processing 233,385 
additional processing for key ranges 335 
additional processing for key-sequenced data set 
creation 233 
and assignment of candidate volumes 235 
and sequence set with data 235 
and the AMDSB in the cluster catalog record 233 
initial processing 231 
NONVSAM processing 249 
SPACE processing 251 
and OS/VS DADSM. 253 
DELETE 
AIX processing 268,384 
CATALOG processing 275 
macro 634 
issued by Close processing 47 
(See also DADSM, Delete routine) 
CLUSTER processing 264,384 
NONVSAM processing 266,384 


PATH processing 268,384 E 
SPACE processing 273 
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deleting 
a catalog record’s set of fields 223 
candidate volume assignments to a data set 265 
records in the data set 117 
deleting a VSAM resource pool 63 
DELREC macro 634 
DEQ macro 634 
derived information 
data set information 514 
data space information 514 
volume information 510 
description of the module listing 279 
determining 
a data control interval’s RBA 317 
amount of unallocated tracks and cylinders on a volume 
(LSPACE processing) 213 
DEVTYPE macro 634 
diagnostic aids 623 
catalog communications area (CCA) register save 
area 639 
error codes 
catalog management 650 
Open/Close/End of Volume 647 
record management 640 
function codes for logical and physical errors 641 
generalized trace facility 639 
macro instructions 631 
messages 626 
virtual storage management 654 
DICT macro 634 
(See also field name dictionary) 
dictionary entry 
example of 531 
format 523 
direct 
access device space management (DADSM) 
OS/VS 
(See DADSM (OS/VS) and OS/VS DADSM) 
summary of 19 
VSAM 
(See DEFINE SPACE, DELETE SPACE, and 
SUBALLOCATE processing) 
GET processing 310 
addressed 79 
keyed 79 
PUT processing for a key-sequenced data set 97 
retrieval 79 
directory, module 413 
external procedure 424 
module name 413 
module packaging 422 
procedure called-by, for 
catalog management 458 
Open/Close/End of Volume 454 
record management 454 
procedure calls, for 
catalog management 436 
Open/Close/End of Volume 434 
record management 434 
disconnect a user’s program from a VSAM dataset 47 
displaying a control blocks’ contents, SHOWCB 
processing 163 
displaying fields of acatalog 262 
distributed free space 467 


DIWA control block 
described and illustrated 589 
mapped by IDADIWA macro 631 
used during 
key-sequenced data set modification 101 
record management request string processing 77 
DLVRP processing 63 
DSCEB control block 
format 0 (free VTOC) 266 
format 1 (identifier) 
and ALTER processing 254 
and DEFINE SPACE processing 251 
and DELETE processing 265,384 
and verifying a nonVSAM caller’s authorization to 
process data sets in a VSAM data space 302 
format 3 (extension) 
and DELETE processing 265 
format 4 (VTOC) 
and ALTER processing 258 
and CONVERTYV processing 276 
and DEFINE CRA processing 246 
and DELETE processing 266,384 
and UPDATE-extend processing 366 
and DEFINE SPACE processing 251 
and DELETE SPACE processing 273 
format 5 (freespace) 
and DELETE processing 265 
DSNAME as a search argument 173 
dynamic string addition 32 
dynamically building a control block (GENCB 
processing) 161 


E 


ECB condition codes 647 
EDB control block 
described and illustrated 590 
mapped by IDAEDB macro 631 
used during 
End of Volume processing 59 
record management processing 77 
end (of data set, key range, or volume) 
for control area during 
add-to-end processing 83 
EOV processing 83 
key-sequenced data set creation 89 
key-sequenced data set modification 83 
for control interval during 
add-to-end processing 83 
of volume called during 
data set creation 87 
end of control area processing 83 
of volume when it calls 
LOCATE processing 181 
UPDATE processing 195 
program organization 302 
summary 20 
ENDREQ macro 634 
issued during 
Close processing 47 
create time 123 
noncreate time 121 
ENQ macro 634 
EODAD-ISAM user’s macro, issued by a QISAM-user’s 
program 157 
ERASE macro 634 
for a key-sequenced data set 135 
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erasing a 
catalog record 265 
user's data record 320 
VSAM catalog 277 
error codes 
catalog management, set in CCAPROB 650 
control block manipulation 653 
Open/Close/End of Volume 
function codes 629 
set during OPEN processing 47 
setin ACBERFLG 647 
record management 
ECB condition codes 647 
feedback return codes 640,641,644 
LERAD exit routine 641 
physical error messages 644 
register 15 contents after a request completes 632 
SYNAD exit routine 644 
errors detected 
during ISAM-Interface Open processing 35 
while closing an ACB 49 
ESETL-ISAM user’s macro, issued by a QISAM-user’s 
program 135 
ESL control block 
built by Open 33 
description 584 
mapped by IDAESL macro 631 
EXCP macro 634 
EXCPVR macro 634 
exit list for ISAM user 35 
exit routines, [/O 392 
EXLST control block 
described and illustrated 592 
ISAM user exit routine addresses in 35 
mapped by IFGEXLST macro 631 
extending adataset 196 
extension catalog record 516 
extent descriptor, and Suballocate processing 205 
external procedure directory 424 
EXTRACT processing (catalog management) 362 


F 


fast path 129,133 
feedback error codes, record management 640,641,644 
field name dictionary 523 
dictionary entry format 523 
entry examples 541 
set-of-fields type codes 541 
FILE option 
ALTER command 254 
DELETE command 264 
format of the module listing 279 
format of catalog record 475 
format-write channel program 580 
forward processing 81 
free 
catalog record 486 
control intervals in the catalog 223 
space 
control area (for data set creation) 89 
control interval (for data set creation) 87 
in acontrol interval 467 


FREEDBUF-ISAM user’s macro, issued by a BISAM-user’s 


program 159 
FREEMAIN macro 634 
function codes for logical and physical errors 641 


function codes for open/close/end of volume 628 
F4DSCB macro 631 
(See also DSCB-format 4 (VTOC)) 


G 


GENCB processing 161 
GENDSP processing 185 
and LOCATE processing 181 
verifying a nonVSAM caller’s authorization to process 
data sets ina VSAM dataspace 302 
generalized trace facility 
and Close processing 296 
and Close (TYPE=T) processing 300 
control blocks recorded 639 
description of 639 
and End of Volume processing 302 
JCL required for 639 
and Open processing 288 
get-field-value processing 215 
GET macro 634 
GET processing 
control interval retrieval 129 
direct retrieval 310 
addressed 79 
keyed 79 
releasing buffer after retrieval 79 
issued by QISAM program 135 
results in EOV processing 59 
sequential retrieval 81,310 
skip-sequential retrieval 310 
GETIX processing 130 
GETMAIN macro 634 
GETREC macro 634 
glossary 661 


graphic symbols used in method of operation diagrams 24 


GTRACE macro 635 
(See also generalized trace facility) 


H 


header elements 
CMB control block 578 
HEB control block 592 
Virtual-Storage Management 654 
header fields, retrieval of 215 
HEB control block 
description 592 
mapped by IDAHEB macro 631 
Virtual-Storage Management 654 
high-address range of the catalog 476 
true-name catalog record format 484 
how to read 
macro instruction usage table 625 
method of operation diagrams 23 
program organization compendium figures 280 
symbolic name usage table 624 
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I 


ICWA control block 
described and illustrated 593 
mapped by IDAICWA macro 631 
used during 
data set creation 91 
data set modification 113 
ENDREQ processing 121 
IDAAIR macro 631 
IDAAMB macro 631 
(See also AMB control block) 549 
IDAAMBL macro 631 
(See also AMBL control block 552) 
IDAAMDSB macro 631 
(See also AMDSB control block 554) 
IDAARDB macro 631 
(See also ARDB control block 556) 
IDABFK macro 631 
IDABFR macro 462 
IDABIB macro 631 
(See also BIB control block 558) 
IDABLPRM macro 631 
(see also BLPRM parameter list 559) 
IDABSPH macro 631 
(See also BSPH control block 561) 
IDABUFC macro 631 
(See also BUFC control block 562) 
IDACALL macro 635 
IDACBTAB macro 631 
IDACB1 macro 635 
IDACB2 macro 635 
IDACIDF macro 631 


(See also control interval definition field 470) 


IDACLWRK macro 631 

(see also CLW work area 577) 
IDACMB macro 631 

(See also CMB control block 578) 
IDACPA macro 631 

(See also CPA control block 578) 
IDACSL macro 631 

(See also CSL control block 583) 
IDACTREC macro 631 
IDADIWA macro 631 

(See also DIWA control block 589) 
IDADSL macro 631 

(See also DSL control block 590) 
IDAEDB macro 631 

(See also EDB control block 590) 
IDAELEM macro 631 

(See also control block manipulation) 
IDAEQUS macro 631 
IDAERMAC macro 635 
IDAERMSG macro 631 
IDAERRCD macro 631 
IDAESL macro 631 

(See also ESL control block 591) 
IDAEXITR macro 635 
IDAFOREC macro 631 
IDAGENC macro 632 
IDAGMAIN macro 635 
IDAHEB macro 631 

(See also HEB control block 592) 
IDAICWA macro 632 

(See also ICWA control block 593) 
IDAIDXCB macro 632 


IDAIICB macro 632 

(See also IICB control block 594) 
IDAITREG macro 632 
IDAIMWA macro 632 

(See also IMWA control block 596) 
IDAIOB macro 632 

(See also IOB (VSAM extension) 597) 
IDAIOSCN macro 632 
IDAIRD macro 632 
IDAIXSPL macro 632 

(See also IXSPL control block 598) 
IDALPMB macro 632 

(See also LPMB control block 599) 
IDAMODC macro 632 
IDAOPWRK macro 632 

(see also OPW work area 600) 
IDAPATCH macro 635 
IDAPDPRM macro 632 
IDAPLH macro 632 

(See also PLH control block 604) 
IDARDF macro 632 

(See also record definition field 469) 
IDAREGS macro 632 

(See also register contents) 
IDARMRCD macro 632 
IDARPLE macro 632 

(See also RPLE control block 612) 
IDARST14 macro 635 
IDASHOW macro 632 
IDASSL macro 631 

(See also SLL control block 612) 
IDASVR14 macro 635 
IDATEST macro 632 
IDAUPT macro 631 

(See also UPT control block 613) 
IDAVAT macro 631 

(See also VAT control block 615) 
IDAVMT macro 631 

(See also VMT control block 620) 
IDAVSRT macro 631 

(See also VSRT control block 620) 
IDAVUCBL macro 632 
IDAVVOLL macro 632 
IDAWAX macro 631 

(See also WAX control block 621) 
IDAWSHD macro 631 

(See also WSHD control block 622) 


IDAxxxx (typical record management external procedure 


name) 


See “External Procedure Directory,”’ page 424, for: 


e the name of the procedure’s module 
e the procedure’s descriptive name 


« the method of operation diagrams and program 
organization figures that describe the procedure 
IDA019xx (typical Open and record management module 


name) 
called by 


See “‘Procedure Called-By Directory,” page 454, fora 
list of procedures that transfer control to the external 


procedures in the module. 


See “External Procedure Directory,” page 424, to find 
the method of operation diagram and program 
organization figure that describe a specific procedure. 
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calls 

See “‘Procedure Calls Directory,” page 434, for a list of 
procedures that the module’s procedures transfer 
control to. 

See “‘External Procedure Directory,” page 424, to find 
the method of operation diagram and program 
organization figure that describe a specific procedure. 

described 

See ‘‘Module Directory,” page 413, to find the method 
of operation diagrams and program organization 
figures that describe the module and its procedures. 

external procedures 

See “‘Module Directory,” page 413, for a list of the 
module’s external procedures. 

loaded in 

See ‘Module Packaging,” page 422, for a list of 
modules contained in each load module. 

other information 

See ‘Diagnostic Aids,’ page 623, for a description of 
the many different kinds of information about the 
module that might help you diagnose and correct a 
problem. 

IECDSECS macro 632 
IECIDSB macro 632 
IECRES macro 635 
IECSDSL1 macro 632 
IEESMCA macro 632 
IEFJECBX macro 632 
IEFJESCT macro 632 
IEFJFCBN macro 632 
IEFJMR macro 633 
IEFPCCB macro 633 

(See also PCCB control block 604) 
IEFQMIOP macro 633 
IEFTCT macro 634 
IEFTIOT1 macro 633 
IEFUCBOB macro 633 
IEZCTGCV macro 633 

(See also CTGCV control block 583) 
IEZCTGFL macro 633 

(See also CTGFL control block 584) 
IEZCTGFV macro 633 

(See also CTGFV control block 585) 
IEZCTGPL macro 633 

(See also CTGPL control block 586) 
IEZCTGVL macro 633 

(See also CTGVL control block 588) 
IEZCTGWA macro 633 

(See also CTGWA control block 588) 
IEZDEB macro 633 
IFGACB macro 633 

(See also ACB control block 547) 
IFGEXLST macro 633 

(See also EXLST control block 592) 
IFGRPL macro 633 

(See also RPL control bllock 609) 
IFG0192I (alias for IFGO192A) 286 
IFG0200S (alias for IFGO192A) 294 
IFG0200T (alias for IFGO192A) 296 
IFG0231T (alias for IFGO192A) 300 
IFGOS5S5OY alias name 59,302 

(See also IFGO200N module) 
IFG0557A (alias for IFGO192A) 302 
IGGCAXWA macro 633 

(See also CAXWA control block 564) 


IGGCCA macro 633 
(See also CCA control block 566) 
IGGMCDCL macro 633 | 
IGGMCMDM macro 633 J 
IGGMCMWA macro 633 
IGGMCTRC macro 633 
IGGMDRWA macro 633 
IGGMEND macro 635 
IGGMF4WA macro 633 
IGGMGVO macro 633 
(See also volume information set of fields 490) 
IGGMODUL macro 635 
IGGMPROC macro 635 
IGGMSAWA macro 633 
IGGMUPDE macro 633 
IGGMVEDC macro 633 
IGGMZLOC macro 633 
IGGPxxxx (typical catalog management external procedure 
name) 
See ‘‘External Procedure Directory,” page 424, for: 
e the name of the procedure’s module 
e the procedure’s descriptive name 
« the method of operation diagrams and program 
organization figures that describe the procedure 
IGGOCLxx (typical catalog management module name) 
called by 
See “Procedure Called-By Directory,” page 458, for a 
list of procedures that transfer control to the external 
procedures in the module. 
See “External Procedure Directory,”’ page 424, to find 
the method of operation diagram and program 
organization figure that describe a specific procedure. 


calls 
See ‘Procedure Calls Directory,” page 436, for a list of . 
procedures that the module’s procedures transfer 
control to. 


See ‘‘External Procedure Directory,” page 424, to find 
the method of operation diagram and program 
organization figure that describe a specific procedure. 

described 

See ““Module Directory,” page 413, to find the method 
of operation diagrams and program organization 
figures that describe the module and its procedures. 

external procedures 

See ““Module Directory,” page 413, for a list of the 
module’s external procedures. 

loaded in 

See ““Module Packaging,” page 422, for a list of 
modules contained in each load module. 

other information 

See “Diagnostic Aids,” page 623, for a description of 
the many different kinds of information about the 
module that might help you diagnose and correct a 
problem. 

IHADCB macro 633 

IHADCBDF macro 633 

IHADECB macro 633 

IHARB macro 634 

IHASRB macro 634 

IICB control block 
described and illustrated 594 
mapped by IDAIICB macro 631 
used during Open processing 35 

IKJPSCB macro 634 

IKJTCB macro 634 2 
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improved control-interval access 129,133 
IMWA control block 

described and illustrated 596 

mapped by IDAIMWA macro 631 
inactive catalog control intervals 223 
index, alternate 

control block structure 539 

format 474 

upgrading 147 


index, prime, processing with control-interval access 128,132 


index AMB control block structure 540 
index buffer used during search 79 
index catalog record 
AMDSSB set of fields 490 
association set of fields 490 
format 487 
header 487 
password set of fields 492 
used during OPEN processing 31 
volume information set of fields 490 
index control interval format 471 
index entry 473 
sections 474 
pointers 474 
index format 470 
index processing 
alternate-index upgrade 147 
control-interval access 128,132 
index processing for sequence-set records 
during create time 
building anentry 326 
writing the record 330,334 
during noncreate time 332 
to add to the end of a key range or dataset 334 
to split acontrol area 336 
index record 
dummy record 473 
entry format 4,57,473 
header field format 471 
sections 474 
pointers 474 
index search 
GET processing 79 
sections 474 
Starting index level 79 
initialize a VSAM dataspace 250 
inserting a(n) 


index entry for a new index record at the next higher level, 


during data set creation 93 
new set of fields into the catalog record 372 


installation-supplied security authorization routine 179 
insufficient space for a new record during add-to-end 


process 83 
introduction 19 
introduction to VSAM 19 


I/O supervisor control block, mapped by IECDIOSB 632 


IOB (VSAM extension) control block 
described and illustrated 597 
mapped by IDAIOB macro 631 
ISAM 
interface processing 
BISAM request translation 159 
program, summary of 19 
QISAM request translation 157 
to close an ISAM-user’s data set 47,49 
to open an ISAM-user’s dataset 31,35 


macro instructions 19 


(Macro instructions issued by ISAM-user’s programs 


are indexed by name.) 
-to-VSAM processing 19 
(See also ISAM Interface) 
user exit routines 35 
IXSPL control block 
described and illustrated 598 
mapped by IDAIXSPL macro 631 


J 


JCL (Job Control Language) 


required for Generalized Trace Facility processing 639 


JFCB control block 31 

Job control language 
JOBCAT=dsname 33 
STEPCAT=dsname 33 

JOBCAT=dsname 33 


K 


key 
compression for asectionentry 109 
ranges, and End of Volume processing 61 
keyed 
direct GET processing 79 
POINT processing 119 
processing and restrictions 75 
sequential 
ERASE processing 117 
GET processing 81 
PUT processing 85 
key-range data set, extendinga 196,198 
KEYWDTAB table 
described and illustrated 599 
GENCEB processing 160 


L 


LERAD exit routine 641 
register contents onentryto 641 
LISTCAT processing 261 
listing a data set’s volumes 186 
listing the contents of a data space 184 


LLOR (least length of record that contains all key fields) 147 


LOAD macro 635 

load modules 413 
LOCATE processing 180 
locating 


a record in a data set using the POINT macro 119 


fields in a catalog record 481 
logical error return codes 641 
low-address range of the catalog 477 
LPA (link pack area) 19 


LPALIB library and VSAM load modules 422 


LPMB control block 
described and illustrated 599 
mapped by IDALPMB macro 631 
LSPACE processing 213 


Index 673 


M 


macro instructions 
coding error messages 623 
modules and the macro instructions each issues 625 
that define data areas 631 
that generate executable code 634 
usage table 625 
managing I/O buffers 
MRKBER processing 139 
SCHBFR processing 143 
WRTBER processing 141 
mass-insert processing 73 
mass storage 
conversion to or from 276,384 
destaging data 295,299 
relative to system, illustrated 19 
staging data 286,299,303 
Mass Storage System, IBM 3850 19 
master catalog 
and the OS/VS system catalog 233 
and user (private) catalogs 243 
connecting another system’s user catalog to, IMPORT 
processing 249 
creating 243 
deletion of 275 
master password 177 
and the user security verification routine 179 
messages 626 
and the module that detects and issues each 626 
for the Generalized Yrace Facility 639 
for a physical error 644 
macro instruction coding errors 624 
method of operation diagrams, description and 
examples 23-125 
microfiche aids 624 
minimum allocation unit 189 
minimum unit count 188 
MODCB processing 163 
MODESET macro 635 
MODIFY processing (catalog management) 219,367 
modifying 
a catalog record field’s contents 219 
a control block (MODCB processing) 163 
catalog record fields 219 
during Close processing 195 
during End of Volume processing 195 
using the Access Method Services ALTER 
command 255 
a catalog record’s sets of fields 221 
a key-sequenced data set 97 


building an index entry and inserting it into an index 


record 105 


creating space to insert a new or modified record ina 


data control interval 101 

single or multiple record insertion 97 

splitting a control area to create free space and to 
generate an index record 103 

splitting an index record to create space for a new 
index entry 111 

updating an existing record 99 


updating a higher level of the index with an entry for 


the new sequence set record 109 


module 
and method of operation diagrams 20 
description 279 
directory 413 
listings 279 
name directory 413 
organization (compendiums) 282 
packaging 422 
prologues 279 
that detects and issues a message 626 
mount volumes (Open) 35 
mounting the volume 
during End of Volume processing 59 
during Open processing 31 
moving a set of fields from a catalog record to its 
extension 382 
MRKBEFER processing 139 
multitype CTGFL 260 
conditions that can be specified 262 


N 


noncreate ENDREQ processing 125 
nonunique data space 197 
and the VSAM catalog 243 
nonVSAM 
catalog record 
format 505 
and its volume information set of fields 507 
dataset 249 
notes for method of operation diagrams 23 


O 


OBTAIN macro 635 
obtaining 
a catalog record field’s value 215 
an available-space map (LSPACE processing) 213 
catalog information 181 
more space for the user’s data set 
and sequence set with data 197 
End of Volume processing 59 
extent descriptor for 197 
from a nonunique data space (Suballocate 
processing) 211 
the control interval number of the catalog record of 
each object in a VSAM data space (GENDSP 
processing) 189 
the next control interval for the data set 
during create processing 321 
during entry-sequenced data set processing 321 
during key-sequenced data set processing 325 
OPEN macro 635 
OPEN parameter list 31 
OPEN processing 
calls LOCATE 181 
method of operation 30 
program organization 285-289 
summary 20 
OPEN work area 
(see OPW work area) 
Open/Close/EOV 
error codes 
inthe ACBERFLG field 647 
function codes 629 
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OS/VS 
(See OS/VS Close modules, OS/VS End of Volume 
modules, and OS/VS Open modules) 
procedure called-by directory 454 
procedure calls directory 434 
summary of 20 
opening a VSAM 
catalog 288 
cluster 
from an ISAM user’s program 285 
from a VSAM user’s program 286 
CRA 407 
OPW work area 
described and illustrated 600 
mapped by IDAOPWRK 632 
organization of this book 3 
OS/VS 
Close modules 
IFGO200N 47 
IFGO200V 47 
IFGO200W 49 
IFGO200Y 49 
IFG0202L 49 
IGC00020 47 
DADSM 
Allocate routine and building the VSAM catalog 243 
Delete routine 273 
Scratch routine 265,201 
End of Volume modules 
IFGOS51F 59 
IGCOOOSE 59 
Open modules 
and GENDSP processing 185 
IDA0192G 302 
IFG0193A 31 
IFGO196V 35 
IFGO196W 35 
IFGO198N 35 
IGCOOOII 31 
SECLOADA 302 
scheduler 
and opening a VSAM catalog 288 
and SUPERLOCATE processing 187 
system catalog 
and the VSAM master catalog 242,274 
CVOL entry in 242,274 


TCLOSE processing and VSAM TCLOSE processing 298 


utilities and GENDSp processing 185 


P 


password 

bypassing 177 

checking 177 

processing, during Open processing 31 

set of fields 
description 480 
used in alternate index catalog record 498 
used in cluster catalog record 495 
used in data set catalog record 492 
used in index catalog record 492 
used in path catalog record 501 

types of 177 


path 
closing 49 
control block structure 535 
opening 31 
processing 145 
work area (for WAX) 620 
path catalog record 
association set of fields 500 
description 499 
password set of fields 501 
PCCB control block 
described and illustrated 607 
mapped by IEFPCCB macro 631 
used during SEARCH 172 
PGFIX macro 634 
PGFREE macro 634 
physical error return codes 644 
PLH control block 
assignment to request string 75 
described and illustrated 607 
mapped by IDAPLH macro 631 
number of 75 
restrictions resulting in error codes 75 
used during 
CHECK processing 125 
data set modification 101 
POINT 
macro 634 
processing 
addressed 119 
keyed 119 
POST macro 634 
preformatted catalog records, during DEFINE CATALOG 
processing 243 
prime index 
format 471 
processing with control-interval access 128,132 
prime-key pointers, alternate index 474 
private catalog 
(See user catalog) 
procedure 
called-by directory 
catalog management 458 
Open/Close/End of volume 454 
record management 434 
calls directory 
catalog management 436 
Open/Close/End of Volume 434 
record management 434 
processing more than one record with a single macro 
instruction request 75 
program organization 279 
program organization figures 
description 280 
example of 280 
flow of control, example of 280 
how to read 280 
notes, example of 281 
programmer messages 626 
protected sphere block 654 
PURGE option (DELETE command) 264 
PUT macro 634 
issued by CLOSE 47 
issued by QISAM program 157 


Index 675 


PUT processing 
control-interval add 131 
control-interval update 133 
entry-sequenced processing 83 
key-sequenced processing 85,97,99 
method of operation 82-85 
program organization 316,338 
requests that resultin EOV 59 

PUTIX processing 132 


putting retrieved catalog data into the caller’s work area 183 


PUTX-ISAM user’s macro, issued by a QISAM-user’s 
program 157 


Q 


QISAM (queued indexed sequential access method) request 
translation 157 
quiescing the data set (during Close processing) 47 


R 


RBA pointers, alternate index 474 
read-ahead buffering 149 
read-channel program 590 
READ-ISAM user’s macro, issued by a BISAM-user’s 
program 159 
read-only password 177 
reading catalog records by the user’s program 261 
restrictions 261 
reading module flow compendiums 280 
rebuild VSAM control blocks 66,68,70 
record 
definition field (RDF) format 469 
format 
catalog (See catalog record) 
data 469 
index 470 
management 
ECB condition codes 647 
error codes 640 
feedback return codes 640,641,644 
LERAD exit routine 641 
logical error codes 641 
procedure called-by directory 454 
procedure calls directory 434 
processing, method of operation diagrams 75 
request processing 75 
SYNAD exit routine 644 
record segment, format, of aspanned record 469 
recoverable catalog support 
description 482 
restrictions 482 
register contents 
saved in the CCA register save area 639 
on entry to the LERAD exit routine 641 
onentry to the SYNAD exit routine 644 
passed to user’s DCB Exit routine 35 
relationship of 
method of operation diagrams to VSAM modules and 
procedures 23 
OS/VS, user’s processing programs, and stored data 19 
relative record data set 
format 467 
processing 135,79-81,119 
relative record number 468 
with GET direct in processing 78 


releasing 
a VSAM catalog 274 
buffer after direct-GET record retrieval 79 
empty VSAM data spaces on a volume 272 
excess buffers for mass-insert mode PUT processing 83 
virtual storage obtained for VSAM control blocks 49 
RELSE-ISAM user’s macro, issued by a QISAM-user’s 
program 157 
removal of 
VSAM ownership from a volume 255 
REMOVEVOLUMES processing 255 
request 
processing 75 
string, assignment of placeholders to 
effect of ENDREQ on 75 
and none available 75 
and sequential processing 75 
RESERVE macro 634 
RESET option 200 
resetting a VSAM data set 200 
resource pool 
BSPH control block 561 
building 63 
closing 55 
control block structure 542 
deleting 63 
managing I[/Q buffers 138-142 
VSRT control block 620 
resource pool parameter list 
(see BLPRM parameter list) 
restrictions 
on control-interval PUT-for-update processing 155 
on record management processing 75 
RETAIN option (DELETE command) 264 
retrieving 
a catalog record field’s value 215 
catalog information 180 
catalog record’s contents 260 
the object’s base catalog record 169 
a control interval for the user’s program 129 
the object’s base catalog record 169 
RETURN macro 634 
returning an empty VSAM data space to the OS/VS 
system 273 
reusable data set processing 200,370 
REUSE processing 200,370 
RPL control block 
assignment of, for ISAM user’s program 35 
chained together 75 
described and illustrated 609 
mapped by IIFGRPL macro 631 
RPLE control block 
described and illustrated 612 
mapped by IDARPLE macro 631 


S 


SCHBFR processing 143 
SEARCH processing 172 
searching the 
catalog 173 
index record to build an index record during data set 
modification 105 
SECLOADA (OS/VS Open module) 300 
section, index record 474 
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section-entry processing 
during data set creation 91 
for higher-level (nonsequence-set) index records 109 
key compression 107 
security authorization 177 
self-describing catalog records 481 
sequence-set record processing 
create time 326 
noncreate time 332 
sequence-set stored with data 
during DEFINE processing 233 
new extent for the data set 199 
sequential 
GET processing 81,310 
retrieval 81 
service request block, mapped by IHASRB macro 634 
set of fields 
modification of 221 
password information 480 
pointer 215 
processing 
adding a set of fields to a catalog record 372 
deleting a set of fields 378 
modifying a field’s contents 376 
moving a set of fields from a catalog record to its 
extension 380 
retrieval of 215 
type codes 385 
types of 480 
SETL-ISAM-user’s macro, issued by a QISAM-user’s 
program 157 
SGIDA401 macro 634 
shared 
control blocks between user programs 31 
data space and the VSAM catalog 243 
shared resources 
BSPH control block 561 
building a resource pool 63 
closing 55 
control block structure 542 
deleting a resource pool 63 
managing I/O buffers 138-143 
VSRT control block 620 
sharing data sets 
control block structure with path processing 535 
show catalog processing 262 
SHOWCAT macro 262 
mapped by IGGSHWPL 263 
SHOWCEB processing 163 
single or multiple record insertion 97 
skip-sequential processing 
GET processing 308 
modifying a key-sequenced dataset 97 
small extent table 211 
SMF (System Management Facilities) records 
type 62 
during Open processing 35 
during UPDATE processing 195 
type 63 
during ALTER processing 255 
during catalog record updating 366 
during DEFINE AIX processing 240 
during DEFINE CATALOG processing 243 
during DEFINE CLUSTER processing 233 
during DEFINE NONVSAM processing 249 
during DEFINE PATH processing 241,390 


during UPDATE-Extend processing 366 

during UPDATE-modify processing 362 
type 64 

during CLOSE processing 49,296 

during Close (TYPE=T) processing 298 

during End of Volume processing 61,302 


type 67 

during DELETE processing 265 
type 68 

during ALTER processing 257 
type 69 


during DEFINE SPACE processing 251 
during LSPACE processing 213 
during UPDATE-Extend processing 366 
VSAM writes records to the SMF data set 35,49,61 
SMFWTM macro 635 
space allocation 
foradataset 61 
forakey range 61 
requirements for End of Volume processing 61 
Space map set of fields 
and the Bit Manipulation routine 211 
format 512 
used during Suballocate processing 211 
spanned records 
format 467 
index entries 473 
processing 78-85,96-101,117 
sphere block 
protected 654 
unprotected 654 
splitting a(n) 
control area 324 
to create free space 103 
control interval 322 
index record to create space for a new index entry 111 
SSL control block 
built by Open 33 
description 612 
mapped by IDASSL macro 631 
starting-search index level 77 
STEPCAT=dsname 31 
storage blocks used in Virtual-Storage Management 634 
storage management, virtual 634 
stored record 467 
string addition, dynamic 31 
SUBALLOCATE processing 
allocating space to a data set 211 
candidate volume assignment 209 
program organization compendium 382 
and UPDATE-Extend processing 197 
subpools used for control blocks 634 
summary of amendments 15 
SUPERLOCATE processing 187 
and LOCATE processing 181 
supervisor call (SVC) processing program 19 
SVC processor 19 
SVC 25 
issued by ISAM Interface processing 31 
to open master catalog 168,358 
SVC 20, issued by ISAM Interface processing 47 
SVC 26 
issued by Access Method Services on O/C/EUv_ 169,181 
issued by SHOWCAT 263 
SVC 29, issued by DELETE processing 265 
SVCLIB and VSAM load modules 422 


Index 677 


symbolic-name usage table 624 
SYNAD 
exit routine 644 
register contents on entry to 644 
ISAM-user’s macro 
and CHECK processing 125 
issued by a QISAM-user’s program 159 
SYNADAF message 644 
built by the ISAM Interface SYNAD routine 159 
SYNCH macro 635 
issued by Close processing 47 
synchronous request processing, deferred 77 
system library and VSAM load modules 422 
System Management Facilities 
(See SMF) 
SYSVSAM (major resource) 31,47 
SYS1.SYSJOBQE data set 31 


T 


TCB control block, used during Open processing 31 
TCLOSE processing 298 
temporary close (TYPE=T) of a VSAM cluster 298 
terminating a record processing request (ENDREQ 
processing) 
during data set creating 123 
not during data set creation 121 
TESTCB processing 163 
testing the contents of a control block 163 
TIME macro 636 
tracing the path through catalog management 
procedures 639 
true-name catalog record 
format 484 
searching forthe 173 
types of catalog records 477 


U 


unique data space 197 
update 
password 177 
processing 195 
UPDATE processing (catalog management) 194,267 
UPDATE -Erase processing (record management) 243 
UPDATE-Extend processing 143,196,269 
update-write channel program 581 
updating a(n) 
catalog record’s fields 219 
header fields 195 
set of fields 195 
control interval for a user’s program 133 
higher level of the index with an entry for the new 


sequence set record during key-sequenced data set 


modification 113 
index 


adding to the end of a key range or dataset 334 
splitting a control area (not at the end of a key range or 


data set) 324 
upgrade catalog record 
association set of fields 504 
description 502 
upgrade set 
closing 53 
opening 39 
upgrading alternate indexes 147 


UPT control block 
description 613 
mapped by IDAUPT macro 631 
user 
DCB exit routine 35 
programs with ISAM macro instructions 19 
security verification routine 179 
user (private) catalog 
catalog record 
format 507 
and its volume information set of fields 509 
creation of 243 
deletion of 275 
and the VSAM master catalog 243 
USVR 
(See user security verification routine 179) 


V 


validity-checking the CTGPL 168 
VAT control block 
description 615 
mapped by IDAVAT macro 631 
VERIFY processing 127 
verifying 
a nonVSAM caller’s authorization to process data sets ina 
VSAM dataspace 302 
the user’s authorization to access a data set 177 
virtual-storage management 654 
VMT control block 
description 620 
mapped by IDAVMT macro 631 
volume 
catalog record 
and its data set directory entry set of fields: 515 
and its data space group set of fields 513 
and its derived information 514,515 
used during GENDSP processing 185 
format 510 
and its space map set of fields 512 
used during End of Volume processing 59 
information set of fields 
used during End of Volume processing 59 
used in data set catalog record 490 
used in index catalog record 490 
used in nonVSAM catalog record 507 
used in user-catalog catalog record 509 
is full and End of Volume processing occurs 61 
mounting and verification 
during end of Volume processing 59 
during Open processing 31 
serial number as a search argument 173 
volume cleanup 254 
VSAM 
catalog 
contents of, during DEFINE CATALOG 
processing 243 
preformatted records in, during DEFINE CATALOG 
processing 243 
catalog management 
entry conditions 169 
LOCATE command, special processing for 169 
checkpoint 64 
checkpoint/restart table 616 
checkpoint/restart work area 618 
communication with other parts of OS/VS 19 
interface routine, during Open processing 31 
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introduction to 19 
load modules 413 
modules, residence in pageable link pack area 19 
Open processing 31 
processing, summary 19 
program components and size 20 
request processing, Method of operation diagrams for 74 
space management, summary of 19 
VSRT control block 
description 620 
mapped by IDAVSRT macro 631 


WwW 


WAIT macro 636 
WAX control block 
description 621 
mapped by IDAWAX macro 631 
write-check channel program 581 
WRITE—ISAM-user’s macro, issued by a BISAM-user’s 
program 159 
writing the last record before closing the data set 47 
WRTBER processing 141 
WSHD control block 
description 622 
mapped by IDAWSHD macro 631 
WTG (where-to-go table) used during open processing 31 
WTO macro 636 
WTOR macro 636 


X 


XCTL macro 636 
XCTLTABL macro 634 


123 


3850 Mass Storage System, IBM 19 


Index 679 


SY 26-3857-0 


MBM 


International Business Machines Corporation 

Data Processing Division 

1133 Westchester Avenue, White Plains, New York 10604 
(U.S.A. only) 


IBM World Trade Corporation 
821 United Nations Plaza, New York, New York 10017 
(International) 


O-ZG8E-9ZAS “WSN U! Paid (OE-OLES “ON Al!4) < i poyray ssaody abesors jenwlA :O1 SAS ZSA/SO 


re 


OS/VS2 SVS IC: Virtual Storage 
Access Method (VSAM) Logic 
SY26-3857-0 


Your comments about this publication will help us to improve it for you. 
Comment in the space below, giving specific page and paragraph references 
whenever possible. All comments become the property of IBM. 


Please do not use this form to ask technical questions about IBM 
systems and programs or to request copies of publications. Rather, 
direct such questions or requests to your local IBM representative. 


If you would like a reply, please provide your name and address 
(including ZIP code). 


Fold on two lines, staple, and mail. No postage necessary if mailed in the U.S.A. (Elsewhere, 
any IBM representative will be happy to forward your comments.) Thank you for your 
cooperation. 


Reader’s 
Comment 
Form 


SY26-3857-0 


CHO SCSHSHESHOSHEHS SEES SHS HS SHES HSHHEHSHS HHH HESHHSHSHSHHSHSHESHEHSFSHSSHESCHSHHEHHSSHESH SASS HESHCHSHSHHHEHTHEHESEHEHSSHSHSHSHHEFSAHRHEHSHEHHHSHHSHSEHEHSHS AHH HSEHOH HE STHSHEHSHSHSFE ASHE HAOSEBEBE HORM BADE @eaeeese0e2ene 82 


ee ae _ \; aoa . & A a ca a a ER i ik a 


Fold and Staple 


First Class Permit 
Number 6090 
San Jose, California 


Business Reply Mail 


No postage necessary if mailed in the U.S.A. 


Postage will be paid by: 


IBM Corporation 

P.O. Box 50020 
Programming Publishing 
San Jose, California 95150 


UBM 


Fold and Staple 


International Business Machines Corporation 
Data Processing Division 
1133 Westchester Avenue, White Plains, New York 10604 


(U.S.A. only) 


IBM World Trade Corporation 
821 United Nations Plaza, New York, New York 10017 


(International) 


O-2S8E-9ZAS “V'S'N UI! pailuld (O€-OLES ON ai!s pours ssaooy abesois jeniiA 7O1 SAS ZSA/SO CS 


c 


